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This publication describes the major debugging 
facilities provided with the System/360 
Operating System for the assembler language 
programmer: 

• Abnormal termination and shapshot dumps. 

• Indicative dumps. 

• Core image dumps. 

• Stand-alone hexadecimal dumps. 

The text explains those aspects of system 
control pertinent to debugging facility offers, 
and outlines procedures for invoking and 
interpreting dumps issued at the three operating 
system levels: PCP , MFT, and MVT. 

Debugging facilities inherent in higher 
languages and additional aids open to the 
assembler language programmer are discussed 
in other SRL publications. 
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Preface 



This publication is intended to help you 
use the debugging facilities provided with 
the IBM System/360 Operating System. To 
fulfill this purpose, the publication is 
divided into two sections: "Section 1: 
Operating System Concepts," and "Section 2: 
Interpreting Dumps." You should read the 
introduction to familiarize yourself with 
the debugging facilities before proceeding 
to Section 1 . 

Section 1 deals with internal aspects of 
the operating system that you should know 
to use the debugging facilities 
efficiently. A working knowledge of this 
information will provide you with the means 
of determining the status of the system at 
the time of the failure, and the course of 
events which led up to that failure. It 
includes information from other System 
Reference Library publications. Program 
Logic Manuals, and Installation Guides. 
You should be familiar with the information 
covered in Section 1 before attempting to 
use Section 2 . 

Section 2 includes instructions for 
invoking, reading, and interpreting dumps 
issued by systems with PCP, MFT, and MVT. 
It presents an after-the-fact look at a 
dump. You've put in a run, it failed, and 
you now have a dump before you. Where do 
you' start; what do you look at; what does 
it all mean? The section begins with a 
general debugging procedure, followed by 
topics dealing with each type of dump. 
Each topic tells how to invoke a particular 
dump, what information the dump contains, 
and how to use this information in 
following the debugging procedure. The 
material in Section 2 is intended to aid 
you in interpreting dumps and isolating 
errors. 

Before reading this publication, you 
should have a general knowledge of 
operating system features and concepts as 
presented in the prereguisite publications. 



Occasionally, the text refers you to other 
publications for detailed discussions 
beyond the scope of this book. 



For information on debugging facilities 
provided within higher languages, consult 
the programmers* guides associated with the 
respective languages. Other System/360 
Operating System publications, such as 
TESTRAN and Messages and Codes , describe 
additional debugging aids provided for the 
assembler language programmer. 
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I— — 



Description 
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2495 Tape 
Cartridge Reader 



Optical Readers 
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1419 Magnetic 
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OS Volume Statistics 



Service Aids 
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SVC 85 has been added to AFPENDIX A. 



SVC numbers 88 and 8 9 have been added to 

APPENDIX A. 



The system module name prefix UN has 
been added to APPENDIX C. 



A description of the UCB sense bytes for 
this unit has been added to APPENDIX F. 



A description of the UCB sense bytes for 
these units has been added to APPENDIX F, 



A description of the UCB sense bytes for 
these units has been added to APPENDIX F. 



SVC number 91 has been added to APPENDIX 
A. 



A new APPENDIX, APPENDIX G, has been 
added to oriefly describe the debugging 
facilities provided by the new service 
aids. 



SVC number 86 has been added to APPENDIX 
A. 
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Item 
Attach in MFT 



Description 



| Areas Affected 



Write to Programmer 
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transient area 
contention problem 
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Hierarchy support 
MVT extension 



The sections on core 
image dumps and 
stand-alone; dumps 
have been combined 



Expanded Index 



Various small 
changes 



Various sections have been added to 
explain the MFT with subtasking system, 
the debugging of modules run en that 
system, and the ABEND/SNAP dumps produced 
by it. 



SVC 90 has been added to APPENDIX A. 



A pointer to the Job Step Control Block 
(JSCB) has been included in APPENDIX H. 



The transient area loading task has 
been included in discussions and artwork 
concerning the MFT TCB gueue. 



A secondary link pack area may be 
present in an MVT system with main 
storage hierarchy support. 



The debugging procedures used for 
these dumps are the same and are now 
presented under the one 
chapter headed: Guide to Using a Core 
Image or a Stand-Alone Dump. 



The index has been expanded and more 
cross referencing entries have been 
provided . 



Various small improvements have been 
made throughout the manual. 
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Introduction 



Debugging is possibly the most important 
aspect of programming. Few programmers, 
especially those involved in control 
program modification, ever produce a 
perfect solution in one run; abnormal 
termination is inevitable and must be 
prepared for. 

Program debugging in an operating system 
environment is made more difficult by the 
large volume of control information, the 
presence of control program routines, and 
the changing contents of main storage. 
Freguently, a large part of debugging lies 
in determining what state the system was in 
when the error occurred and which essential 
information was obscured. 

To debug problem programs efficiently, 
you should be familiar with the system 
control information reflected in dumps . 
This control information, in the form of 
control blocks and traces, tells you what 
has happened up to the point of error and 
where key information related to the 
program is located. 

This book is therefore designed to: 

• Help you prepare proper dump data set 
definitions. 

• Provide an insight into the IBM 
System/360 Operating System and its 
complex aspects of task management, 
storage supervisor, control blocks, and 
debugging aids . 

• Give you a starting point, an approach, 
and a method of debugging. 

The IBM System/ 360 Operating System 
provides extensive degugging facilities to 
aid you in locating errors and determining 
the system state quickly. Some debugging 
Ids, such as console messages, provide 
imited information that may not always 
elp you identify the error. This manual 
iiscusses those debugging facilities that 
provide you with the most extensive 
information: 

a. Abnormal termination (ABEND) and 
snapshot (SNAP) dumps. 

b. Indicative dumps. 

c. Core image dumps. 

d. Stand-alone hexadecimal dumps. 

ABEND and SNAP Dumps are invoked by ABEND 
and SNAP macro instructions, respectively. 
They are grouped in a single category 
because they provide identical information. 



In addition to a hexadecimal dump of main 
storage, they can contain conveniently 
edited control information and displays of 
the operating system nucleus and trace 
table . 

Indicative dumps contain control 
information useful in isolating the 
instruction that caused an abnormal end of 
task situation. The information is similar 
to that given in an ABEND/SNAP dump, but 
does not include a dump or main storage. 

Core image dumps are taken by the damage 
assessment routine (DAR) at the time of a 
system failure. The dump is written to a 
SYS1.DUMP data set which you may print by 
means of the IEAPRINT print dump program. 
The dump consists of a first page, 
containing edited control information, 
followed by a dump of the printable 
contents of main-storage, beginning at 
location 00. Each line contains the 
hexadecimal address of the first byte in 
the line, eight main-storage words in 
hexadecimal, and the same eight words in 
EBCDIC. 

Stand-alone d umps, invoked by the dump 
program you have produced from the IMDSADMP 
macro instruction (see Appendix G) or by a 
System/360 Operating System card program 
number UT-056, offer a complete picture of 
main storage at a given time. They are, 
for the most part, unedited. Each line 
contains the hexadecimal address of the 
first byte in the line, eight main-storage 
words in hexadecimal, and the same eight 
words in EBCDIC. 

General Notes : 

• Displacements and addresses shown in 
the text and illustrations of this 
publication are given in decimal 
numbers, followed by the corresponding 
hexadecimal number in parentheses, 
e.g., TCB+14(E); location 28 (1C); SVC 
42 (2A). All other numbers in the text 
are decimal, e.g., the seventeenth word 
of the TCB; a 4-word control block; 15 
job steps. 

• Control block field names referred to 
are those used in the IBM System/360 
Operating System: System Control 
Blocks manual, GC28-6628. 

• Wherever possible, diagrams, and 
reproductions of dumps have been 
included to aid you during the 
debugging process. 



Introduction 



Section 1: Operating System Concepts 



To effectively use the debugging aids 
provided by the IBM System/360 Operating 
System, you should be familiar with those 
control blocks, traces, and other control 
information that can lead you quickly to 
the source of error . This section of the 
manual introduces you to the control 
information that you must know to interpret 
dumps. It is divided into four topics: 

• TASK MANAGEMENT 

• MAIN STORAGE SUPERVISION 

• SYSTEM CONTROL BLOCKS AND TABLES 

• TRACES 



The first 
aspects of ta 
management, r 
represented i 
describes the 
blocks and ta 
errors. The 
features that 
events that 1 



two topics deal with those 

sk management and main storage 

espectively, that are 

n dumps. The third topic 

remaining system control 
bles helpful in pinpointing 
last topic covers tracing 

are useful in re-creating the 
ed to an error condition. 



Note ; The descriptions of system control 
blocks and tables in this section emphasize 
function rather thcin byte-by-byte contents. 
Appendix H summarizes the contents of those 
control blocks most useful in debugging. 

For a more detailed description of 
system control blocks and tables, please 
see the System Control Blocks publication, 
GC28-6628. 



Task Management 

The task management control information 
most useful in debugging with a dump 
includes the task control block and its 
associated request blocks and elements. 
These items have the same basic functions 
at each of the three control program 
levels. Their functions, interactions, and 
relationships to other system features are 
discussed in this topic. A summary of how 
task supervision differs at each system 
level concludes the topic. 



Task Control Block 

The operating system keeps pointers to all 
information related to a task in a task 
control block (TCB) . For the most part, 
the TCB contains pointers to other system 
control blocks. By using these pointers, 
you can learn such facts as what 1/0 



devices vsere allocated to the task, which 
data sets were open, and which load modules 
were requested. 

Figure 1 shows some of the control 
inforiration that can be located by using 
the pointers in the TCB. Later, in the 
discussion of system control blocks and 
tables, figure 1 is expanded to show the 
actual nlock names and pointer addresses. 
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Fiqure 1. Control Information Available 

Through the TCB 



Request Blocks 

Frequently, the routines that con prise a 
task are not all brought into main storage 
with the first load nodule. Instead, they 
are requested by the task as it requires 
them. Tnis dynamic loading capability 
necessitates another type of control block 
to describe each lead module associated 
witn a task — a request block (RB) . An RB 
is created by the control program when it 
receives a request from the system or from 
a problem program to fetch a load nodule 
for execution, and at other times, such as 
when a type II supervisor call (SVC) is 
issued. By looking at RBs, you can 
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determine which load modules have been 
executed, why each lost control, and, in 
most cases, which one was the source of an 
error condition. 

There are seven types of RBs created by 
the control program: 

• Program request block (PRB) 

• Supervisor request block (SVRB) 

• Interrupt request block (IRB) 

• Supervisor interrupt request block 
(SIRB) 

• Loaded program request block (LPRB) 

• Loaded request block (LRB) 

• Finch request block (FRB) 

Of these, you will most often encounter 
the PRB and SVRE in dumps. The type of RB 
created depends on the routine or load 
module with which it is associated. 



LPRB: (FCP and K.FT only): An LPRB is 
created when a LOAD macro instruction is 
issued unless the LOAD macro instruction 
specifies: 

• A routine that has already been loaded. 

• A routine that is being loaded in 
response to a LOAD macro instruction 
previously issued by a task in the 
partition (MFT with subtasking) . 



A routine that is 
LRB) . 



'only loadable" (see 



An LPRB is located immediately before the 
load module with which it is associated. 
Routines for which an LPRB is created can 
also be invoked by XCTL, LINK, and ATTACH 
macro instructions. 



PRB (Systems with PCP and MFT) : A PRB is 
created whenever an XCTL, LINK, or ATTACH 
macro instruction is issued. It is located 
immediately before the load module with 
which it is associated. 



PRB (Systems with MVT) : A PRB is created 
whenever an XCTL or LINK macro instruction 
is issued. It is located in a fixed area 
of the operating system. 



SVRB : An SVRB is created each time a type 
II, III, or IV supervisor call is issued. 
(Type I SVC routines are resident, but run 
disabled; they do not require a request 
block.) This block is used to store 
information if an interruption occurs 
during execution of these SVC routines. A 
list of SVCs, including their numbers and 
types, appears in Appendix A. 



IRB : An IRB is created each time an 
asynchronous exit routine is executed. It 
is associated with an event that can occur 
at an unpredictable time during program 
execution, such as a timing routine 
initiated r>y an STIMER macro instruction. 
The IRB is filled at the time the event 
occurs, just before control is given to the 
exit routine. 



SIRB : An SIRB is similar to an IRB, except 
that it is associated only with 
IBM-supplied input/output error routines. 
Its associated error routine is fetched 
from the SYS1.SVCLIB data set. 



LRB: (PCP and MFT only): The LRB is a 
shortened form of an LPRB. Routines 
associated with LRBs can be invoked only by 
a LOAD macro instruction. This attribute 
is assigned to a routine through the OL 
(only loadable) subparameter in the PARM 
parameter of the EXEC statement that 
executes the linkage editor. The most 
common reason for assigning this attribute 
is that linkage conventions for XCTL, LINK, 
and ATTACH are not followed. This request 
block is located immediately before the 
load module with which it is associated. 

FRB (MFT with subtasking only) : An FRB is 
created and attached to the job pack area 
queue, during LOAD macro instruction 
processing, if the requested module is not 
already in the job pack area. The FRB 
describes a module being loaded in response 
to a LOAD macro instruction. Any 
subsequent requests for the same module, 
received while it is still being loaded, 
are deferred by means of wait list elements 
(WLEs) queued to the FRB. When the module 
is fully loaded, an LRB or an LPRB is 
created, the FRB is removed from the job 
pack area queue, and any requests, 
represented by wait list elements, are 
reinitiated. 

Figure 2 shows the relative size of the 
seven types of RBs and the significant 
fields in each. 

In Figure 2, the "size" field tells the 
number of doublewords in both the RB and 
its associated load module. The PSW 
contained in the "resume PSW" field 
reflects the reason that the associated 
load module lost control. Other fields are 
discussed in succeeding topics. 



Task Supervision 11 



LPRB 






"12 Major RB address 

(MFT with subtasking) 


-8 
-4 


Load list pointers 
(PCP, MFT) 

Absent (MVT) 





Module name 
(PCP, MFT) 
Last half of user's 
PSW (MVT) 


8 

Size 


Flags 


12(C) 
Use Ct 


A Entry point (PCP, 
A MFT); CDE (MVT) 


16 (10) 

Resume PSW 




28(1"C)1 

WaitCt 


f Next RB 



LRB 






-4 



Loac lis 
(PCP, h 

Absent 

Module 
(PCP, k 
Last ha 
PSW (M 


t pointers 
AFT) 

(MVT) 


name 
AFT) 

f of user's 
VT) 


8 
S 


ze 


Flags 


n (c ) 

Use Ct 


A Entry point (PCP, 
A MFT); CDE (MVT) 



Program Extent List 

' "'" Length of extent in 

hiearchy 



i Length of extent in 

hiearchy 1 

3 Address, of extent in 

hiearchy 

12(C) Address of extent in 
hiearchy 1 



PRB 






lIlilllHIBBPIIIBIIll 





Module name 
(PCP, MFT) 
Last half of user's 
PSW (MVT) 


8 

Size 


Flags 


12(C) 
Use Ct 


A Entry point (PCP, 
A MFT); CDE (MVT) 


16 (10) 


Resume PSW 




28(1C) 
WaitCt 


t Next RB 



FRB 






-8 

Load list 
"4 pointers 




Module name 


8 

Size 


Flags 


12(C) 

Address of WLE 


16 (10) 

Address of TCB 


20 (14) 

Address of LPRB 





Note: Program extent list is added to LPRB, LRB, or PRB if the 
program described was hiearchy block loaded. 



h 



SVRB 



IRB 



SIRB 



Module name 
(PCP, MFT) 
Last half of user's 
PSW (MVT) 


8 

Size 


Flags 


12(C) 
Use Ct 


4 

4 


Entry point (PCP, 
MFT); CDE (MVT) 


16 (10) 

Resume PSW 




28(1C) 
WaitCt 


t 


Next RB 


32 (20) 


Register 
Save Area 


96 (60) 


Extended 
Save Area 



Module name 
(PCP, MFT) 
Last half of user's 
PSW (MVT) 



Size 



12(C) 
Use Ct 



Flags 



* Entry point (PCP, 
A MFT); CDE (MVT) 



16 (10) 



PSW 



28(1C) 
WaitCt 



32 (20) 



Next RB 



Register 
Save Area 






Module name 
(PCP, MFT) 
Last half of user's 
PSW (MVT) 


8 «-. 
Size 


Flags 


12(C) 
Use Ct 


* Entry point (PCP 
A MFT); CDE (MVT) 


16 (10) 


Resume PSW 




28 (IC) 
WaitCt 


t Next RB 


32 (20) 


Register 
Save Area 





Figure 2. RB Formats 
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Thus far, the characteristics of the TCB 
and its associated RBs have been discussed. 
With the possibility of many RBs 
subordinate to one task, it is necessary 
that queues of RBs be maintained. In 
systems with PCP and MFT without 
subtasking, two queues are maintained £>y 
the system — the active RB queue and the 
load list. In MFT systems with subtasking, 
a job pack area queue, containing FRBs, and 
LRBs and LPRBs that represent reenterable 
modules is also maintained. MVT systems 
maintain an active RB queue and a contents 
directory. The contents directory is made 
up of three separate queues: the link pack 
area control queue (LPAQ); the job pack 
area control queue (JPAQ) ; and the load 
list. 



Active RB Queue 

The active RB queue is a chain of request 
blocks associated with active load modules 
and SVC routines. This queue can contain 
PRBs, SVRBs, IRBs, SIRBs, and under certain 
circumstances, LPRBs. Figure 3 illustrates 
how the active RB queue links together the 
TCB and its associated RBs. 
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Figure 3. Active RB Queue 

The request blocks in the active RB 
queue in Figure 3 represent three load 
modules. Load module A invokes load module 
B, and E, in turn, invokes C. When 
execution of A began, only one RB existed. 
When the first invoking request was 
encountered, a second RB was created, the 
TCB field that points to the most recent RB 
was changed, and A*s status information was 



stored in RB-A. A similar set of actions 
occurred when the second invoking request 
was encountered. As each load module is 
executed and control is returned to the 
next higher level load module, its RB is 
removed from the chain and pointers are 
updated accordingly. 



Load List 

The lead list is a chain of request blocks 
or elements associated with load modules 
invoked by a LCAB macro instruction. The 
load list differs from the active RB queue 
in that REs and associated load modules are 
not deleted automatically. They remain 
intact until they are deleted with a DELETE 
macro instruction or job step termination 
occurs. By looking at the load list, you 
can determine whicn system and problem 
program routines were loaded before the 
dump was taken. Tne format of the load 
list differs with control program levels. 

' Systems with PCP and MFT (without 
subtasking) : At these control program 
levels, the load list associated with a TCB 
contains LRBs and LPRBs. RBs on the load 
list are linked together somewhat 
differently from those on the active RB 
queue because of the characteristics of the 
LOAD macro instruction. Because REs may be 
deleted from a load list in a different 
order than they were created (depending en 
the order of DELETE macro instructions) , 
they must have both forward and backward 
pointers. Figure 4 illustrates how a load 
list links together a TCB and three RBs. 




Figure 4. Load List (PCP, MFT) 



Task Supervision 13 



Here, each RB contains a pointer both to 
the previous KB and the next most recent KB 
in the list. If there is no previous or 
more recent RB, these fields contain zeros 
and a pointer to the TCB, respectively. 

Another field of a load list RB that 
merits consideration is the use count. 
Whenever a LOAD macro instruction is 
issued, the load list is searched to see if 
the routine is already loaded. If it is 
loaded, the system increments the use count 
by one and passes the entry point address 
to the requesting routine. 

Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one. When it reaches zero, 
the RB is removed from the load list and 
storaqe occupied by the associated routine 
is freed. 

System s with MFT (with subt aski ng) : At 
this control program level, the load list 
is used as described for PCP and MFT 
without subtasking, with the following 
exceptions: 

1. The LRBs and LPRBs queued on the load 
list represent modules that are not 
reenterable. LRBs and LPRBs 
representing reenterable modules are 
queued on the job pack area queue. 

2. When a LOAD macro instruction is 
issued, the system searches the job 
pack area queue before searching the 
load list. 

Systems with MVT : Instead of LRBs and 
LPRBs created as a result of LOAD macro 
instructions, the load list maintained by a 
system with MVT contains elements 
representing load modules. Load list 
elements (LLEs) are associated with load 
modules through another control medium 
called the contents directory . 

The contents directory is made up of 
three separate queues : the link pack are a 
control queue (LPAQ ) , the job pack area 
control queue (JPAQ) , and the load list . 

The LPAQ is a record of every program in 
the system link pack area. This area 
contains reenterable routines specified by 
the control program or by the user. The 
routines in the system link pack area can 
be used repeatedly to perform any task of 
any job step in the system. The entries in 
the LPAQ are contents directory entries 
(CDEs) . 

There is a JPAQ for each job step in the 
system that uses a program not in the link 
pack area. The JPAQ, like the LPAQ, is 
made up of CDEs. It describes routines in 
a job step region. The routines in the job 
pack area can be either reenterable or not 



reenterable. These routines however, 
cannot be used to perform a task that is 
not part of the job step. 

The load list represents routines that 
are rirought into a job pack area or found 
in the link pack area by the routines that 
perform the Load function. The entries in 
the lead list are load list elements, not 
CDEs. Each load list element is associated 
witn a CDE in the JFAQ or the LPAQ; the 
programs represented in the load list are 
thus alsc represented in one of the other 
contents directory queues. 

Load list elements also contain a count 
field that corresponds to the use count in 
a LPRE or LRB . Each time a LOAD macro 
instruction is issued for a load ircdule 
already represented on the load list, the 
count is incremented by one. As 
corresponding DELETE macro instructions are 
issued, the count is decremented until it 
reaches zero. An LLE has the following 
format: 



Res 


t Next LLE 


Count 


fCDE 



Byte 0: 



Reserved (RES). 



Bytes 1-3: Pointer to the next more recent 
LLE on the load list. 



Byte 4: 



Count. 



Eytes 5-7: Pointer to the corresponding 
CDE. 

More will be said about CDEs in the next 
topic cf Section 1, titled "Main Storage 
Supervision. " 

Jo b Pack Area Queue (MFT with Subtasking 
only) 

In an MFT system with subtasking, the job 
pack area queue is a chain of request 
blocks associated with load modules invoked 
by a LOAD macro instruction. The queue 
contains FRBs, and those LRBs and LPRBs 
that represent reenterable nodules. FRjbs 
are queued en the job pack area queue until 
the requested module is completely loaded. 
When the module is completely loaded into 
main storaqe, the i?RB is removed from the 
Job Pack Area Queue and replaced with an 
LRB or an LPRE queued on the Job Pack Area 
Queue if the loaded module is reenterable, 
and on the load list if it is not. 

In the MIT with subtasking 
configuration, the load list represents 
non-reenterable nodules, while the job pack 
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HMMI 



area queue represents only reenterable 
modules within the partition. These RBs on 
the job pack area queue are not deleted 
automatically, but remain intact until they 
are deleted by a DELETE macro instruction, 
or until job step termination occurs. 
Reenterable load modules are therefore 
retained in the partition for use by the 
job step task or any subtasks which ir.ay be 
created. 



Whenever a LOAD macro instruction is 
issued, the job pack area queue is 
searched. If the routine is already fully 
loaded and represented by an LRB or an LPRB 
on the JPAQ (the routine is reenterable) , 
the system increments the use count by one 
and passes the module entry point address 
to the requesting routine. If an FRB for 
the requested module is found, a wait list 
element (WLE) representing the deferred 
request is queued to the FRB, and the 
request is placed in a wait. When the 
requested routine is fully loaded, the 
system releases the request from the wait 
condition, and the request is re-initiated. 
If no RB for the requested routine is 
found, an FRB is created and queued on the 
JPAQ. The system then searches the load 
list of the requesting task for an RB for 
the requested routine. If an RB for that 
routine is found on the load list (the 
routine is not reenterable) , the use count 
is incremented by one, the entry point 
address of the module is passed to the 
requesting routine, and the FRB is dequeued 
from the JPAQ. If no RB is found on the 
load list, the FRB remains on the JPAQ and 
the system begins loading the requested 
module. 



Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one (the DELETE routine 
ignores FRBs) . When the use count reaches 
zero, the RB is removed from the queue. 

Figure 5 illustrates how the job pack area 
queue is chained to a TCB. 

In Figure 5, each RB contains a pointer to 
the previous RB and a pointer to the next 
RB on the queue. If there is no previous 
RB on the queue, that pointer will contain 
zero; if there is no next RB on the queue 
(this RE is the most recent on the JPAQ), 
the next RB pointer will point back to the 
job pack area queue pointer in the PIB. 

Two wait list elements (WLEs) are queued 
to FRE-C representing deferred requests 
waiting until the initial loading of the 
module is completed. The last WLE contains 
zero in its forward pointer, indicating 
that it is the last element on the WLE 
queue . 




i i 



•Figure 5. Job Pack Area queue 



Effects Of LINK, ATTACH, XCTL. and L OAD 

In the previous paragraphs we have 
mentioned the LINK, ATTACH, XCTL, and LCAD 
macro instructions. A brief description of 
each will be helpful at this point. LINK, 
ATTACH, XCTL, and LOAD, though similar, 
have some distinguishing characteristics 
and system dependencies worth mentioning. 
By knowing what happens when these macro 
instructions are issued, you can make more 
effective use of the active RE queue and 
the lead list. 



LINK : A LINK results in the creation of a 
PRB chained to the active KB queue. Upon 
completion of the invoked routine, control 
is returned to the invoking routine. In 
systems with PCP and MFT, the RB is removed 
from the queue. The stofaqe occupied cy 
the invoked routine is freed unless the 
routine is also represented on the load 
list, or en the job pack area queue in MFT 
systems with subtasking. In systeirs with 
MVT, the use count in the RE is decremented 
by one; if it is then zero, the RB and the 
storage occupied by the routine are narked 
for deletion. A LINK macro instruction 
generates an SVC 6. 

ATTACH: An ATTACH is siirilar to tne other 



three macro instructions in systems with 
PCP or with MFT without subtasking. In 
systems with MFT (with subtasking) or MVT, 
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ATTACH is the means for dynamically 
creating a separate but related task -- a 
subtask. At the PCP and MFT (without 
subtasking) levels, tasks cannot create 
subtasks. ATTACH effectively performs the 
same functions as LINK at these control 
program levels, with two notable additions: 

1. You can request an exit routine to be 
given control upon normal completion 
of the attached routine. 

2. You can request the posting of an 
event control block upon the routine's 
completion . 

Exit routines are represented by additional 
RBs on the active RB queue. The ATTACH 
macro instruction generates an SVC 42C2A). 



XCTL ; An XCTL also results in the creation 
of a PRB and immediate transfer of control 
to the invoked routine. However, XCTL 
differs from the other macro instructions 
in that, upon completion of the invoked 
routine, control is passed to a routine 
other than the invoking routine. In fact, 
an XCTL does not result in the creation of 
a lower level RB. Instead, the invoking 
routine and its associated RBs are deleted 
when the XCTL is issued. In effect, the RB 
for the invoked routine replaces the 
invoking routine's RB. The XCTL macro 
instruction generates an SVC 7. 



LOA D: The LOAD macro instruction was 
treated previously in the discussion of the 
load list. To summarize: the system 
responds to a LOAD by fetching the routine 
into main storage and passing the entry 
point address to the requesting iroutine in 
register 0. Because the system does not 
have an indication of when the routine is 
no longer needed, a LOAD must be 
accompanied by a corresponding DELETE macro 
instruction. If not, the routine and its 
RB remain intact until the job step is 
terminated. The LOAD macro instruction 
generates an SVC 8 . 



System Task Control Differences 

Thus far, this topic has dealt with the 
aspects of task supervision that are 
similar at the three control program 
levels. There are, however, some major 
areas of difference, namely: 

1. The number of tasks that can be known 
to the system concurrently. 

2. The layout of main storage. 

3. The additional main storage control 
information in systems with MVT . 



The first two subjects are discussed 
here, by system. The third subject, 
because of its volume, is discussed in the 
next topic of Section 1. 

Systems with PC P: The distinguishing 
characteristic of an operating system with 
the primary control program is that it 
handles a single task. It has one TCB at 
any given time, which resides in the system 
nucleus. Jobs are processed sequentially, 
one step at a time. ATTACH macro 
instructions are treated similarly to 
LINKS; that is, they do not create 
suctasks. 

Figure 6 is a snapshot of meiin storage 
in a system with PCP. The fixed area 
contains those routines, control blocks, 
and tables that are brought into main 
storage at IPL, and never overlaid. It 
also may contain optional access method and 
SVC routines which are normally 
nonresident, and an optional list of 
absolute addresses for routines which 
reside on direct access devices. These 
options can be selected during system 
generation. 




FIXED 
AREA 



Figure 6. Main Storage Snapshot (PCP) 

The dynamic area contains, in lower main 
storage adjacent to the fixed area, the 
processing proqram and routines invoked by 
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LINK, XCTL, and ATTACH macro instructions. 
At some points in the job processing flow, 
the processing program may be a job 
management routine. Upper main storage 
contains the user save area, user parameter 
area, task input/output table, routines 
reguested by LOAD macro instructions, and 
non-resident routines, such as access 
method routines . 



Systems with MFT (Without Subtasking) ; 
Operating Systems that provide 
multiprogramming with a fixed number of 
tasks without the subtasking option (MFT 
without subtasking) , resemble systems with 
PCP except that the dynamic area may be 
divided into as many as 52 partitions. 
Partitions sizes and attributes are defined 
during system generation. These sizes and 
attributes remain fixed unless redefined by 
the operator during or after system 
initialization. Each partition contains 
one task. Three additional tasks, the 
transient area loading task, the 
communication task, and the master 
scheduler task, reside in the fixed area. 
One TCB exists for each task. All TCEs are 
linked by dispatching priority in a TCB 
gueue, beginning with the TCEs for the 
three resident tasks. 

The dynamic area may contain as many as 
3 reading tasks, as many as 36 writing 
tasks, and as many as 15 job step tasks, so 
long as the total number of tasks does not 
exceed 52. Jobs are processed seguentially 
in a partition, one job step at a time. An 
ATTACH macro instruction, as in systems 
with PCP, is treated similarly to a LINK. 



Because more than one task exists at any 
given time, systems with MFT introduce the 
concept of task switching . The relative 
dispatching priority of tasks is determined 
by the TCB queue. Control of the CPU must 
often be relinquished by one task and given 
to another of higher priority. MFT dumps 
contain task switching information often 
important in reconstructing the environment 
at the time of task failure. 



Figure 7 is a snapshot of main storage 
in a system with MFT (without subtasking) , 
having n partitions. The fixed area 
contains the nucleus (including the TCB 
queue, transient area loading task, 
communications task, and master scheduler 
task), and the system queue area. The 
fixed area may also contain the same system 
generation options discussed under the 
heading "Systems with PCP," and a 
reenterable load module area, which is 
optional in MFT. Each partition in the 
dynamic area is similar to the entire 
dynamic area of PCP. 




EACH PARTITION LOOKS 
LIKE PCP's DYNAMIC AREA 



• Figure 7. 



Main Storage Snapshot 
Without Subtasking) 



(MFT 



Systems with MFT (With Subtasking) : 
Operating Systems that provide 
multiprogramming with a fixed number of 
tasks with the subtasking option (MFT with 
subtasking) more closely resemble systems 
with MVT, and differ from MFT systems 
without subtasking in the following major 
areas: 

1. MFT with subtasking has an ATTACH 
facility similar to the ATTACH 
facility in MVT. While the number of 
job step TCBs still may not exceed 15, 
the number of tasks in any partition, 
and therefore the total number of 
tasks in the system, is now variable. 
Job step task TCBs reside in the 
nucleus. They are queued, following 
the system task TCBs, in the same 
manner as in MFT without subtasking. 
When subtasks are created, however, 
the subtask TCBs are placed in the 
system queue area and queued to the 
job step TCBs according to dispatching 
priority (TCBTCB field), and according 
to subtask relationships (TCBNTC, 
TCBOTC, TCBLTC fields). 
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S upervisor and Data Manag ement 
S ervices , GC 28-6646 ." 

Figure 8 is a snapshot of main storage in 
an MFT system with subtasking heiving n. 
partitions. Note here that the TCBs in the 
nucleus are all job step TCBs, while those 
residing in the sytem gueue area are the 
subtask TCBs.. 




EACH PARTITION DOES NOT LOOK LIKE 
PCP's DYNAMIC AREA 

Figure 8. Main Storage Snapshot (MFT Witn 
Subtasking) 

Syste m s with MVT : In Operating Systems 
that provide multiprogramming with a 
variable number of tasks (MVT) , as many as 
15 job steps can be executed concurrently. 



Kach jot> step requests an area of main 
storage called a region and is executed as 
a j ob step task . In addition, system tasks 
request regions and can be executed 
concurrently with joij step tasks. 



.Regions are assigned automatically frcir 
the dynamic area when tasks are initiated. 
Reqicns are constantly redefined according 
to the main storage requirements of each 
new task. 

With the facility of attaching subtasks 
available to each task through the ATTACH 
macro instruction, the number of TCBs in 
the system is variable. Tasks gain control 
of the CPU ny priority. To keep track of 
the priority and status of each task in the 
system, 'ICEs are linked together in a TCB 
queae . 

Figure 9 is a snapshot ot main storage 
in a system with MVT. The fixed area is 
occupied by the resident portion of the 
control program loaded at IPL. The system 
qu eue space is reserved for control blocks 
and tables built by the control program. 
The dynamic area is divided into 
variable-sized regions, each of which iLi 
allocated to a job step task or a system 
task. Finally, the link pack area contains 
selected reenterable routines, loaded at 
IPL. If an IBM 23bl Core Storage device 
and Main Storage Hierarchy Support are 
included in the system, a secondary link 
pack area may be created in Hierarchy 1 to 
contain other reenterable routines. 




SYSTEM 
QUEUE 
AREA 



FIXED 
AREA 



Figure 9. Main Storage Snapshot (MVT) 
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Main Storage Supervision 



Because main storage is allocated 
dynamically in an operating system, current 
storage control information must be kept. 
Such information is contained in a series 
of control blocks called queue elements . 
In systems with PCP and MFT without 
subtasking, queue elements reflect areas of 
main storage that are unassigned. In MFT 
systems with subtasking, a gotten subtask 
area queue element (GQE) is introduced to 
record storage obtained for a subtask by a 
supervisor issued GETMAIN macro 
instruction. In systems with MVT f more 
elaborate storage control is maintained; at 
any given time, queue elements reflect the 
distribution of main storage in regions, 
subpools, and load modules. A familiarity 
with storage control information is 
necessary to understand the main storage 
picture provided in dumps. 

The dynamic area may be significantly 
expanded by including IBM 2361 Core Storage 
in the system. Main Storage Hierarchy 
Support for IBM 2361 Models 1 and 2 permits 
selective access to either processor 
storage (hierarchy 0) or 2361 Core Storage 
(hierarchy 1) . If IBM 2361 Core Storage is 
not included, requests for storage from 
hierarchy 1 are obtained from hierarchy 0. 
If 2361 Core Storage is not present in an 
MVT system ana a region is defined to exist 
in two hierarchies, a two-part region is 
established within processor storage. The 
two parts are not necessarily contiguous. 



third word points to the highest position 
in hierarchy 1 plus one. If 2361 Core 
Storage is not included in the system, the 
hierarchy 1 pointers are set to zero. 



FQE: Each free area in main storage is 
described by an FQE. FQEs are chained, 
beginning with the FQE associated with the 
free area having the highest address. If 
Main Storage Hierarchy Support is present, 
one FQji chain exists for each hierarchy 
specified. Each FgE occupies the first 8 
bytes of the area it describes. It has tne 
following format: 




Bytes 0-3: Pointer to FQE associated with 
next lower free area or, if 
this is the last FQE, zeros. 

Bytes 4-7: Number of bytes in the free 
area. 



Storage control in systems with PCP is 
summarized in Figure 10. 



Storage Control in Systems With PCP 

The chain of storage control information in 
a system with PCP begins at a table called 
the main storage supervisor (MSS) boundary 
box, located in the system nucleus. This 
table, pointed to by the TCBMSS field of 
the TCB, contains three words. The first 
word points to a free queue element (FQE) 
associated with the highest free area in 
processor storage. The second word points 
to the first doubleword outside the 
nucleus. The third word contains the 
highest address in processor storage plus 
one. 

If Main Storage Hierarchy Support for 
IBM 2 361 Models 1 and 2 is included in the 
system, the boundary box is expanded to six 
words. The first byte of the expanded 
boundary box contains a "1" in bit 7 to 
indicate that hierarchy support is 
included. The second set of three words 
describes storage in hierarchy 1. The 
first word of this second set points to an 
FQE associated with the highest free area 
in hierarchy 1. The second word points to 
the first doubleword in hierarchy 1. The 
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Figure 10. Storage Control (PCP) 
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Storage Control in Systems wit h MFT 
(Without Subtasking) 

Storage control information in systems with 
MFT without subtasking is similar to that 
in systems with PCP, except that one MSS 
boundary box is maintained for each 
partition. The TCB associated with the 
partition contains a pointer (TCBMSS) to 
the boundary box. 

If Main Storage Hierarchy Support is 
included, the first half of each expanded 
boundary box describes the processor 
storage (hierarchy 0) partition segment, 
and the second half describes the 2 361 Core 
Storage (hierarchy 1) partition segment. 
Any partition segment not currently 
assigned storage in the system has the 
applicable boundary box pointers set to 
zero. If the partition is established 
entirely within hierarchy 0, or if 2361 
Core Storage is not included in the system, 
the hierarchy 1 pointers in the second half 
of the expanded boundary box are set to 
zero. If a partition is established 
entirely within hierarchy l f the hierarchy 
pointers in the first half of the 
expanded boundary box are set to zero. 

The boundary box format for MFT is 
identical to the format for PCP.. The 
pointers, however, point to the boundaries 
of the partition and to the partition FQEs 
rather than to the boundaries of storage. 
Figure 11 summarizes storage control in 
systems with MFT. 



FIXED 
AREA 



Storage Control in Systems with MFT (With 
Subtasking) 



Storage control information for the job 
step or partition TCB in MFT systems with 
subtasking is handled in the same way as in 
MFT systems without subtasking. However, 
when subtasks are created, the supervisor 
builds another control block, the Gotten 
subtask area Queue Element (GQE) . The GQEs 
associated with each subtask originate from 
a one word pointer addressed by the TCBMSS 
field of the subtask TCB. 



GQE : Each area in main storage belonging 
to a subtask, and obtained by a supervisor 
issued GETMAIN macro instruction, is 
described by a gotten subtask area queue 
e lement (GQE) . GQEs are chained in the 
order they are created. The TCBMSS field 
of the subtask TCB contains the address of 
a word which points to the most recently 
created GQE. 




ONE „ 
PARTITIONS 



FIXED. 
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Figure 11. Storage Control for a Partition • Figure 12. Storage Control for Subtask 

(MFT Without Subtasking) Storage (MFT with Subtasking) 
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If Main Storage Hierarchy Support is 
present in the system, the GQE chain can 
span from hierarchy to hierarchy 1 and 
back in any order. Each GQE occupies the 
first eight bytes of the area it describes, 
and has the followina format: 



Number ©F 8ytes 



Bytes 0-3: Pointer to the Previous GQE or, 
if zero, this is the last GQE 
on the chain. 

Bytes 4-7: Number of bytes in the gotten 
subtask area. 

Figure 12 summarizes the chaining of GQEs 
to a subtask TCB. 



Storage Control for a Region in Systems 
with MVT 

Unassigned areas of main storage within 
each region of a system with MVT are 
reflected in a queue of partition queue 
elements (PQEs) and a series of free block 
queue elements (FBQEs) . 

PQE : The partition queue associated with a 
region resides in the system queue space. 
It is connected to the TCBs for all tasks 
in the joo step through a dummy, PQE located 
in the system queue space. A dummy PQE has 
the following format: 



f First PQE 


f Last PQE 



Bytes 0-3: Pointer to the first PQE in the 
partition queue. 

Bytes 4-7: Pointer to the last PQE in the 
partition queue. 



In systems that do not include the 
rollout/roll in feature or Main Storage 
Hierarchy Support for IBM 2361 Models 1 and 
2, there is one PQE for each job step. If 
the rollout feature is used, additional 
PQEs are added each time a job step borrows 
storage space from existing steps or 



acquires unassioned free space to satisfy 
an unconditional GiTMAIN request. These 
additional PQEs are removed from the queue 
as the rollin feature is used. If Main 
Storage Hierarchy Support is present, one 
PQE exists for each hierarchy used by the 
job step. A PQE has the following format: 



f First FBQE 



if Last FBQE 



f Next PQE 



f Previous PQE 



12(C) 



13(D) 



Owning TCB 



Region Size 



16 (10) 



17(11) 



20 (14) 21 (15) 



Region 



24 (18) 



25(19) 



28 (1C) 29 (ID) 



Bytes 1-3: Pointer to the first FBQE or, 
if there are no FBQEs, a 
pointer to the PQE itself. 

Bytes 5-7: Pointer to the last FBQE or, if 
there are no FBQEs, a pointer 
to the PQE itself. 

Bytes 9-1KB): pointer to the next PQE or, 
if this is the last PQE, zeros. 

Bytes 13-15 (D-F): Pointer to the previous 
PQE or, if this is the first 
PQE, zeros. 

Bytes 17-19(11-13): Pointer to the TCB of 
the owning job step. 

Bytes 21-23(15-17): Size of the region, in 
2K (2048) bytes. 

Bytes 25-27 (19-1B) : Pointer to the first 
byte of the region. 

Byte 28 (1C) : Kollout flags. 



FBQE : The FBQEs chained to a PQE reflect 
the total amount of free space in a region. 
Each FBQE is associated with one or more 
contiguous 2K blocks of free storage area. 
FBQEs reside in the lowest part of their 
associated area. As area distribution 
within the region changes, FBQEs are added 
to and deleted from the free block queue. 
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An FBQE has the following format: 



| Next FBQE Res 



! Pr$vfws FBQE 



Res J Number of bytes 



Bytes 1-3: Pointer to the next lower FBQE 
or, if this is the last FBQE, a 
pointer to the PQE. 

Bytes 5-7: Pointer to the preceding FBQE, 
or, if this is the first FBQE, 
a pointer to the PQE. 



Storage Control for a Subpool in Systems 
with MVT 

Main storage distribution within each 
subpool is reflected in a subpool gueue 
element (SPQE) and gueues of descriptor 
gueue elements (DQ^s) and free gueue 
elements (FQEs) . 



SPQ E: SPQEs are associated with the 
subpools created for a task. SPQEs reside 
in the system gueue space and are chained 
to the TCB(s) that use the subpool. They 
serve as a link between the TCB and the 
descriptor gueue, and may be part of a 
subpocl gueue if the task uses more than 
one subpool. If a subpool is used by more 
than one task, only one SPQE is created. 
An SPQE has the following forirat: 



Bytes 9-12 (C) : Number of bytes in the free 
block. 

The remaining main storage in a region 
is used by problem programs and system 
programs. For convenience in referring to 
storage areas, the total amount of space 
assigned to a task represents one or more 
numbered subpools . (Subpools can also be 
shared by tasks.) Subpools are designated 
by a number assigned to the area through a 
GETMAIN macro instruction. Subpool numbers 
available for problem program use range 
from through 127. Subpool numbers 128 
through 255 are either unavailable or used 
by system programs . 

Storage control elements and gueues for 
a region are summarized in Figure 13. 



DYNAMIC , 
AREAS i 



SYSTEM 
QUEUE < 
SPACE 




Figure 13. Storage Control for a legion 

(MVT) 



',"■..' 


f Next SPQE 


SP # 


t First DQE 



Byte 0: 

Bit - Subpool is owned by this task 

if zero; shared, and owned by 

another task, if one. 
Bit 1 - This SPQE is the last on the 

gueue, if one. 
Eit 2 - Subpool is shared and owned by 

tnis task, if one. 
Eits 3-7 - Reserved. 

Bytes 1-3: Pointer to next SPQE or, in 
last SPQE, zero. 

Byte 4: Subpool number. 

Bytes 5-7: Pointer to first DQE or, if the 
subpool is shared, a pointer to 
the "owning" SPQE. 

DQE : BQEs associated with each SPQE 
reflect the total amount of space assigned 
to a subpool. Each DQE is associated with 
one or more 2K blocks of main storage set 
aside as a result of a GETMAIN macro 
instruction. Each DQE is also the starting 
point for the free gueue. A DQE has the 
following forirat: 



• "" • , 

wmm 



t First FQE 



f N«xt DQE 



i*w: 



f First 2K block 



Res 



Length of area 



12(C) 13(D) 



22 Programmer's Guide to Debugging (Release 19) 



Bytes 1-3: Pointer to the FQE associated 
with the first free area. 

Bytes 5-7: Pointer to the next DQE or, if 
this is the last DQE, zeros. 

Bytes 9-11 (B): Pointer to first 2K block 
described by this DQE. 

Bytes 13-1 5 (D-F) : Length in bytes of area 
described by this DQE. 




SYSTEM 
QUEUE <J 
SPACE 



Bytes 1-3: Pointer to the next lower FQE 
or, if this is the last FQE, 
zeros. 

Bytes 5-7: Number of bytes in the free 
area. 

A subpool is summarized in Figure 14. 



Storage Control for a Load Module in 
Systems with MVT 

Each load module in main storage is 
described by a contents directory entry 
(CDE) and an extent list (XL) that tells 
how much space it occupies. 

CDE: The contents directory is a group of 
queues, each of which is associated with an 
area of main storage. The CDEs in each 
queue represent the load modules residing 
in the associated area. There is a CDE 
queue for the link pack area and one for 
each region, or job pack area. The TCB for 
the jcb step task that requested the region 
points to the first CDE for that region. 
Contents directory queues reside in the 
system queue space. A CDE has the 
following format: 



♦ Next CDE 



EBCDIC program name 



•Figure 14. Storage Control for a Subpool 
(MVT) 

FQE : The FQE describes a free area within 
a set of 2K blocks described by a DQE. It 
occupies the first eight bytes of that free 
area. Since the FQE is within tne subpool, 
it has the same protect key as the task 
active within that subpool. Extreme care 
should be exercised to see that FQEs are 
not destroyed by the problem program. If 
an FQE is destroyed, the free space that it 
describes is lost to the system and cannot 
be assigned through a GETMAIN. As area 
distribution within the set of blocks 
changes, FQEs are added to and deleted from 
the free queue. An FQE has the following 
format : 



Res 


| Nexf FQE 


Res 


Number of bytes 



■V'4l 



fXL 



16(10) 17(11) 



20(14) 21(15) 



Byte 0: Flag bits, when set to one, 
indicate: 
Bit - Module was loaded by NIP. 
Eit 1 - Module is in process of being 

loaded. 
Bit 2 - Module is reenterable. 
Bit 3 - Module is serially reusable. 
Bit 4 - Module may not be reused. 
Bit 5 - This CDE reflects an alias 

name (a minor CDE) . 
Bit 6 - Module is in job pack area. 
Bit 7 - Module is not only-loadable. 

Bytes 1-3: Pointer to next CDE. 

Bytes 5-7: Pointer to the RB. 

Bytes 8-15(F): EBCDIC name of load module. 

Byte 16(10): Use count. 
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Bytes 17-19(11-13): Entry point address of 
load module. 



Byte 20: Flag bits, when set to one, 

indicate: 
Bit - Reserved. 
Bit 1 - Module is inactive. 
Bit 2 - P,n extent list has oeen built 

for the module. 
Bit 3 - This CDE contains a relocated 

alias entry point address. 
Bit 4 - The module is refreshable. 
Bits 5, 6, 7 - Reserved. 

Bytes 21-23(15-17): Pointer to the XL for 
this module or, if this is a 
minor CDE, pointer to the 
major CDE. 

XL: The total amount of main storage 
occupied oy a load module is reflected in 
an extent list (XL) . XLs are located in 
the system queue space. An XL has the 
following format: 



length of XL 



Nunber of CSECTs! 



Length of CSECT- 1 



length of ( / CSECT - H 



12(C) 



Locotion of CSECT - t 



locotTort of ( ( CSECT - N 



Bytes 0-3: Length of XL in bytes. 

Bytes 4-7: Number of scattered control 
sections. If the control 
sections are block- loaded, 1. 



Remaining 
cytes: 



Length in bytes of each 
control section in the module 
(4 bytes for each control 
section) and starting location 
of each control section (4 
bytes for each control 
section) . 



Storage control elements and queues for 
load modules are summarized in Figure lb. 



,jlpSM^|§| 




Figure 15, 



Storage Control for a Load 
Module (MVT) 
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System Control Blocks and Tables 



Event control Block (ECB) 



In addition to the key task management 
control blocks (TCB and RB) , several other 
control blocks containing essential 
debugging inf ormation are built and 
maintained by data management and job 
management routines. Although seme of 
these blocks are not readily identifiable 
on a storage dump, they can be located by 
following chains of pointers that begin at 
the TCB. 



The ECB is a 1-word control block created 
when a BEAD or WRITE macro instruction is 
issued, initiating an asynchronous I/Q 
operation. At the completion of the I/O 
operation, the access method routine posts 
the ECB. By checking this ECB, the 
completion status of an I/O operation can 
b<= determined . In all access methods but 
QTAM, the ECB is the first word of a larger 
block, the data event control block. 



The control blocks discussed here have 
the same basic functions at each control 
program level. The precise byte-by-byte 
contents of the blocks can be found in the 
publication System Control Blocks . Block 
contents useful in debugging are listed in 
Appendix H. 



Communications Vector Table (CVT) 



Input/Output Block (IOB) 

The IOB is the source of information 
reguired by the I/O supervisor. It is 
filled in with information taken from an 
I/O operation reguest. In debugging, it is 
useful as a source of pointers to the DCB 
associated with the I/O operation and the 
channel commands associated with a 
particular device. 



The CVT provides a means of communication 
between nonresident routines and the 
control program nucleus. Its most 
important role in debugging is its pointer 
to two words of TCB addresses. These words 
enable you to locate the TCB of the active 
task, and from there to find other 
essential control information. Storage 
location 16(10) contains a pointer to the 
CVT. 



Task Input/Output Table (TIOT) 

A TIOT is constructed by job management for 
each task in the system. It contains 
primarily pointers to control blocks used 
by I/O support routines. It is usually 
located in the highest part of the main 
storage area occupied by the associated 
task (in systems with MVT, TIOTs are in the 
system gueue space.) Through the TIOT, you 
can obtain addresses of unit control blocks 
allocated to the task, the job and step 
name, the ddnames associated with the step, 
and the status of each device and volume 
used by the data sets. 



Unit Control Block (UCB) 

The UCB describes the characteristics of an 
I/O device. One UCB is associated with 
each I/O device configured into a system. 
The UCB's most useful debugging aid is the 
sense information returned by the last 
sense command issued to the associated 
device. 



Data Control Block (DCB) 

The DCE is the place where the operating 
system and the problem program store all 
pertinent information about a data set. It 
may be completely filled by operands in the 
DCB macro instruction, or partially filled 
in and completed when the data set is 
opened, with subparameters in a DD 
statement and/or information from the data 
set label. The format of DCBs differs 
slightly for each of the various access 
methods and device types. The DCB's 
primary debugging aids are its pointers to 
the DEB and current IOB associated with its 
data set, and the offset value of the 
ddname in the TIOT. 

Data Extent Block (DEB) 

A DEB describes a data set's auxiliary 
storage assignments and contains pointers 
to some other control blocks. The DEB is 
created and gueued to the TCB at the time a 
data set is opened. Each TCB contains a 
pointer to the first DEB on its chain. 
Through this pointer you can find out which 
data sets are opened for the task at a 
given time, what extents are occupied by 
open data sets, and where the DCB and UCB 
are located. 

Summary of Control Block Relationships 

Figure 16, an expansion of Figure 1, shows 
the relationships among the principal 
control blocks and tables in the System/3 60 
Operating System. 



System Control Blocks and Tables 25 



Location 
16( 10) 



+0 TCB Words 



IB +13(D) 



+9 



1-25(19) 



5 



s 



(f 



^> 



+45 (2D) 



+33(21) 



168 
(44) JL 11+21(15) 



u : 



o B 



+17(11) 



=71 



Lisr 



•Figure 16. Control Block Relationships 
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Traces 



Two features that assist you in tracing the 
flow of your program are the save area 
chain and the trace table (the trace table 
is optional at system generation.) Both 
these features are edited and clearly 
identified on ABEND/SNAP dumps, and can be 
located easily on core image and 
stand-alone dumps. 



Save Area Chain 

When control is passed from one load module 
to another, the requested module is 
responsible for storing the contents of 
general registers. This necessitates the 
use of separate save areas for each level 
of load module in a task. With the 
different types of linkages that can occur, 
save areas must be chained so that each one 
points to both its predecessor and 
successor. 

A save area is a block of 72 bytes 
containing chain pointers and register 
contents. It has the following format: 







"Next higher save area ) 





4 




) T Next lower save area 


Register 14 ) 



12(C) 



Register 15 



lof / / registers 0-12 



16(10) 



20(14) 



Bytes 4-7: Pointer to the next higher 

level save area or, if this is 
the highest level save area, 
zeros. 

Bytes 8-11 (B): Pointer to the next lower 
level save area or, if this is 
the lowest level save area, 
unused. 

Bytes 12-15 (C-F) : Contents of register 14 
(optional) 

Bytes 16-19(10-13): Contents of register 
15 (optional) 

Bytes 20-71 (14-3F) : Contents of registers 
to 12 

The save area for the first or highest 
level load module in a task (save area 1) 



is provided by the control program. The 
address of this area is contained in 
register 13 when the load module is first 
entered. It is the responsibility of the 
highest level module to: 



1. Save registers 0-12 in bytes 

20-71 (14-3F) of save area 1 when it is 
entered. 

2. Establish a new save area (save area 
2). 

3. Place the contents of register 13 into 
bytes 4-7 of save area 2. 

4. Place the address of save area 2 into 
register 13. 

5. Place the address of save area 2 into 
bytes 8-11 (B) of save area 1. 

At this point, tne save areas appear as 
shown in Figure 17. 



Save area 2 





Save area 1 






+ 4 


0000 


+ 8 


Save area 2 






+ 20(14) 


Contents of 
registers 0-12 



+4 



+68(44) 



Save area 1 



Register 13 



Save area 2j 



Figure 17. Save Area Trace 



If a module requests a lower level 
module, it must perform actions 1 through 4 
to ensure proper restoration of registers 
when it regains control. (Action 5 is not 
required, but must be performed if the dump 
printout of the field is desired.) A 
module that does not request a lower level 
module need only perform the first action. 

ABEND and SNAP dumps include edited 
information from all save areas associated 
with the dumped task under the heading 
"SAVE AREA TRACE". In a stand-alone dump, 
the highest level save area can be located 
through a field of the TCB. Subsequent 
save areas can be located through the save 
area chain. 
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Trace Table 

The tracing routine is an optional feature 
specified during system generation. This 
routine places entries, each of which is 
associated with a certain type of event, 
into a trace table. The size of the table 
is also a system generation option; when 
the table is filled, the routine overlays 
old entries with new entries, beginning at 
the top of the table (the entry having the 
lowest storage address) . The contents and 
size of a trace table are highly 
system-dependent. 

Systems with PCP ; Trace table entries for 
systems with PCP are 4 words long and 
represent occurrences of SIO, I/O, and SVC 
interruptions. Figure 18 shows the word 
contents of each type of entry. 



SIO 


CC/Dev 


CAW 


CSW 







1 


2 








Vo 


I/O OLD PSW 


CSW 









2 








SVC 


SVC OLD PSW 


Reg 


Reg 1 



Figure li 



2 3 

Trace Table Entries (PCP) 



Systems with MFT : Systems with MFT have 
the same type of trace table entries as 
PCP, plus an additional type representing 
task switches, as shown in Figure 19. 

Systems with MVT : The trace table in a 
system with MVT is expanded to include more 
entries and more information in each entry. 
Trace table printouts occur only on SNAP 
dumps and stand-alone dumps. Entries are 
eight words long and represent occurences 
of SIO, external, SVC, program, and I/O 
interruptions, and dispatcher loaded PSWs. 



Figure 20 shows the word contents of trace 
table entries for SNAP dumps and 
stand-alone dumps. Figure 21 shows the 
contents of trace table entries as filled 
by MVT with Model 65 multiprocessing. (SSM 
— set system mask — entries are 
optional. ) 
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2 
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Figure 19. Trace Table Entries (MFT) 
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•Figure 20. Trace Table Entries (MVT) 
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SVC and 
Program 
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Figure 21. Trace Table Entries (KVT with Model 65 multiprocessing) 
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Section 2: Interpreting Dumps 



How are ABEND dumps invoked? What does 
information in a SNAP dump mean? What 
useful facts can be gleaned from an 
indicative dump? Where are key tables and 
control blocks in a stand-alone dump? 

These and similar debugging questions 
are answered in this section of the manual. 
Topics comprising Section 2 describe each 
of the debugging facilities introduced 
earlier — what information they provide, 
where to find this information , and how to 
apply it. 

The introduction to txiis section 
describes a general procedure for debugging 
with a dump. Subsequent topics deal with 

• ABEND/SNAP dumps issued by systems witn 
PCP and MFT. 

• ABEND/SNAP dumps issued by systems with 

MVT . 

» Indicative dumps. 

• Core Image dumps. 

• Stand-alone dumps. 



a user code, the error is in your program, 
and the completion code should lead you 
directly to the source of error. Normally, 
however, a system code will be listed; this 
indicates that the operatinc system issued 
the AEEND. Often the system completion 
code gives enough information for you to 
determine the cause of the error. The 
explanations of system completion codes, 
along with a short explanation of the 
action to be taken by the programmer to 
correct the error, are contained in the 
publication IBM System/360 Oper ating 
System: Messages and Codes , GC28-6631. 



To locate the load module that had 
control at the time the dump was issued, 
find tne RB associated with the m.cdule. If 
the dump resulted from an ABEND or SNAP 
macro instruction, the third most recent RB 
on the queue represents the load module 
that had control. The most recent and 
second most recent RBs represent the ABDUMP 
and AEEND routines, respectively. Core 
image dumps and stand-alone dumps contain 
PSW information that can be used to 
identify the load module in control. 



Each topic includes instructions for 
invoking the dump, a detailed description 
of the dump's contents, and a guide to 
using the dump, with specific instructions 
for following the general debugging 
procedure. 



General Debug ging P rocedure 

The first facts you must determine in 
debugging with an operating system dump are 
the cause of the abnormal termination and 
whether it occurred in a system routine or 
a problem program. To aid you in making 
these determinations, ABEND, SNAP, and 
indicative dumps provide two vital pieces 
of information — the completion code and 
the active RB queue. Similar information 
can be obtained from a core image dump or a 
stand-alone dump by analyzing PSWs and 
re-creating an active RB queue. 

A Completion code is printed at the top 
of ABEND, SNAP, and indicative dumps. It 
consists of a system code and a user code. 
The system code is supplied by the control 
program and is printed as a 3-digit 
hexadecimal number. The user code is the 
code you supplied when you issued your own 
ABEND macro instruction; it is printed as a 
U-digit decimal number. If the dump shows 



Once you have located the RB or load 
module, look at its name. If it dees not 
have a name, it is probably an SVRB for an 
SVC routine, sucn as one resulting from a 
LINK, ATTACH, XCTL or LOAD macro 
instruction. To find the SVC number, lock 
at the last three digits of the resume PSW 
in the previous RB on the queue. If a 
previous RB does net exist, the; PB in 
question is an SVRB for a routine invoked 
by an XCTI macro instruction. Register 15 
in the extended save area of the RB gives a 
pointer to a parameter list containing the 
name of the routine that issued the XCTL. 

If the RB dees not bear the name of one 
of .your load modules, either an RB was 
overlaid or termination occurred during 
execution of a system routine. The first 
three characters of the name identify the 
system component; Appendix C contains a 
list o± component names to aid you in 
determining which load module was being 
executed. 

If the RB bears the name of one of your 
load modules, you can be reasonably certain 
that the source of the abnormal termination 
lies in your onject code. However, an 
access method routine may be at fault. 
This possibility arises because your 
program branches to access method routines 
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through a supervisor-assisted linkage, 
instead of invoking them. Thus, an access 
method routine is not represented on the 
active RB queue. To ascertain whether an 
access method routine was the source of the 
abnormal termination, you must examine the 
resume PSW field in the RB. If the last 3 
bytes in this field point to a main storage 
address outside your program, check the 
load list to see if an access method 
routine is loaded at that address. If it 
is, you can assume that it, and not your 
program, was the source of abnormal 
termination. 

Abnormal Termination in System Routines : 
By analyzing the RB's name field or the SVC 
number in the previous RB, you can 
determine which system load module 
requested the termination. If the RE has a 
system module name, the first three 
characters tell you the name of the system 
component. The remaining characters in the 
name identify the load module in error. 

Remember, although a system routine had 
control when the dump was taken, a problem 
program error may indirectly have been at 
fault. Such a situation might result from 
an incorrectly specified macro 
instruction, an FQil modified inadvertently, 
a request for too much storage space, a 
branch to an invalid storage address, etc. 
To determine the function of the load 
module that had control, consult Appendix 
C. With its function in mind, the 
completion code together with an 
examination of the trace table may help you 
to uncover which instruction in the problem 
program incorrectly requested a system 
function. 



Program Check Interruptions in Problem 
Programs : If you have determined from the 
completion code or PSWs and evaluation of 
the RB queue that the dump resulted from a 
program check in your problem program, 
examine the status of your program in main 
storage. (If you have received only an 
indicative dump, you must obtain either an 
ABEND/SNAP dump or a stand-alone dump at 
this point.) Locate your program using 
pointers in the RB. If its entry point 
does not coincide with the lower boundary 
of the program, you can find the lower 
boundary by adding 32(20) to the address of 
the RB (systems with PCP and MFT) . The 
RB's size field gives the number of 
doublewords occupied by the RB, the 
program, and associated supervisor work 
areas. ABEND/SNAP dumps with PCP and MFT 
have the storage boundaries of the problem 
program calculated and printed. 

Next, locate the area within your 
program that was executed immediately prior 
to the dump. To do this, you must examine 



the program check old PSW. Pertinent 
information in this PSW includes: 

Bits 12-15: AMWP bits 

Bits 32,33: Instruction length in 
half words. 

Bits 40-63: Instruction address 



A useful item of information in the PSW 
is the P bit of the AMWP bits (bits 12-15) . 
If the P bit is on, the PSW was stored 
while the CPU was operating in the problem 
program state. If it is off, the CPU was 
operating in the supervisor state. 

Find the last instruction executed 
before the dump was taken by subtracting 
the instruction length from the instruction 
address. This gives you the address of the 
instruction that caused the termination. 
If the source program: was written in a 
hiqher level language, you must evaluate 
the instructions that precede and follow 
the instruction at fault to determine their 
function. You can then relate the function 
to a statement in tne source program. 

Other Interruptions in Problem Program s : 
If the completion code or PSWs and the 
active RB queue indicate a machine check 
interruption, a hardware error has 
occurred. Call your IBM Field Engineering 
representative and show him the dump. 

If an external interruption is 
indicated, with no other type of 
interruption, the dump probably was taken 
by the operator. Check with him to find 
out why the dump was taken at this point. 
The mcst likely reasons are an unexpected 
wait or a program loop. If a trace table 
exists, examine it for the events preceding 
the trouble or, if the trace table was made 
ineffectual by a program loop, resubmit the 
job and take a dump at an earlier point in 
the program. You may want to consider 
using the TESTRAN facility to find where 
the program loop occurred. 

The remaining causes of a dump are an 
error during either execution of an SVC or 
an I/O interruption. In either case, 
examine the trace table. Entries in tne 
table tell you what events occurred leading 
up to termination. From the sequence of 
events, you should be able to determine 
what caused a dump to be taken. From here, 
you can turn to system control blocks and 
save areas to get specific information. 
For example, you can find the sense 
information issued as a result of a unit 
check in the UCB, a list of the open data 
sets from the DEB chain, the CCW list from 
the IOB, the reason for an I/O interrupt in 
the status portion of the CSW, etc. 
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Debugging Procedure Summary 



1. Look at the completion code or PSW 
printouts to find out what type of 
error occurred. Common completion 
codes and causes are explained in 
Appendix B. 

2. Check the name of the loeid module that 
had control at the time the dump was 
taken by looking at the active RB's. 

3. If the name identifies a system 
routine, proceed to step 4. If the 
name identifies a problem program and 
the completion code or PSW indicates a 
program check, proceed to step 6. If 
the name identifies a problem program, 
and the completion code or PSW 
indicates other than a program check, 
proceed to step 10. 



4. Find the function of the system 
routine using Appendix C. 

5. If the dump contains a trace table, 
begin at the most recent entry and 
proceed backward to locate the most 
recent SVC entry indicating the 
problem state. From this emtry, 
proceed forward in the table, 
examining each entry for an error that 
could have caused the system routine 
to be terminated. 



If the name identifies one of your 
load modules, check the instruction 
address and the load list to see if an 
access method routine last had 
control. If so, return to step 4. 



Locate your program in the dump. 

Locate the last instruction executed 
before the dump. 



Examine the instruction and, if the 
program was written in a high-level 
language, the instructions around it 
for a possible error in object code. 



jiiiii L 



10. If a machine check interruption is 
indicated, call your IBM Field 
Engineering representative. 

11. If only an external interruption is 
indicated, ask the operator why he 
took the dump. Resubmit the job and 
take a dump at the point where trouble 
first occurred. 

12. Examine the trace table, if one is 
present, for events leading up to the 
termination. Use trace table entries 
and/or information in system control 
blocks and save areas to isolate the 
cause of the error. 
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ABEND/SNAP Dump 
(Systems With PCP and MFT) 



ABEND/SNAP dumps for systems with PCP and 
MFT are discussed together because they are 
nearly identical in format. System 
differences in the contents of the dumps 
are shaded for easy recognition. Debugging 
instructions for the dumps are discussed 
later, in the guide to using the dump. 

ABEND/SNAP storage dumps are issued 
whenever the control program or problem 
program issues an ABEND or SNAP macro 
instruction, or the operator issues a 
CANCEL command requesting a dump, and 
proper dump data sets have been defined. 
However, in the event of a system failure, 
if a SYSl.DUMP data set has been defined 
and is available, a full core image dump 
will be provided, as explained in the 
section headed "Core Image Dump." 

Since, in an MFT with subtasking system, 
subtasks may be created, you may receive 
one or more partial dumps in addition to 
the complete dump of the task that caused 
the abnormal termination. A complete dump 
includes a printout of all control 
information related to the terminating 
task, and the nucleus and all allocated 
storage within the partition in which the 
abending task resided. A partial dump of a 
task related to the terminating task 
includes only control information. The 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump. Figure 22 is a copy of the first few 
pages of a complete ABEND dump of an MFT 
system with subtasking. It illustrates 
some of the key areas on an ABEND dump, as 
issued by systems with PCP and MFT. Those 
portions of the dump that would only appear 
on a dump of a subtasking system are noted 
in the later discussions as appearing only 
in a dump of an MFT with subtasking system. 



Invoking an ABEND/SNAP Dump (PCP, MFT) 

ABEND dumps are produced as a result of an 
ABEND macro instruction, issued either by a 
processing program or an operating system 
routine. The macro instruction requires a 
DD statement in the input stream for each 
job step that is subject to abnormal 
termination. This DD statement must be 
identified by one of the special ddnames 
SYSABEND or SYSUDUMP . SYSABEND results in 
edited control information, the system 
nucleus, the trace table, and a dump of 
main storage; SYSUDUMP excludes the nucleus 
and the trace table. In the event of a 
system failure, the Damage Assessment 
routine (DAR) attempts to write a core 
image dump to the SYS1.DUMP data set. A 
full explanation of core image dumps may be 



found in the section headed "Core Image 
Dump . " 

SNAP Dumps result from a problem proqram 
issuing a SNAP macro instruction. The 
contents of a SNAP dump vary according to 
the operands specified in the SNAP macro 
instruction. SNAP dumps also require a DD 
statement in the input stream. This DD 
statement has no special characteristics 
except that its ddname must not be SYSAEEND 
or SYSUDUMP. The processing program must 
define a DCB for the snapshot data set. 
The DCB macro instruction must contain, in 
addition to the usual DCB requirements, the 
operands DSORG=PS, RECFM=VBA, MACRF= (W) , 
BLKSIZE=882 or 1632, and LRLCL=125. In 
addition, the DCB must be opened before the 
first SNAP macro instruction is issued. 

Reference ; The SNAP and DCE macro 
instructions are discussed in the 
publication Supervisor and Data Management 
Macro Instructions . 

Device and Space Considerations : DD 
statements for ABEND/SNAP dumps, must 
contain parameters appropriate for a basic 
sequential (BSAM) data set. Data sets can 
be allocated to any device supported by the 
basic sequential access method. There are 
several ways to code these DD statements 
depending on what type of device you choose 
and when you want the dump printed. 

If you wish to have the dump printed 
immediately, code a DD statement defining a 
printer data set. 



| //SYSABEND DD UNIT-1443, DCB= ( . . . 

L 



If your installation operates under a 
system with PCP or MFT, and a printer is 
associated with the SYSOUT class, you can 
also obtain immediate printing by routing 
the data set through the output stream. 



|//SNAPDUMP DD SYSOUT=A, DCB= ( . . . 

L 



This type of request is the easiest, 
most economical way to provide for a dump. 
All other DD statements result in the tying 
up of an output unit or delayed printing of 
the dump. 

If you wish to retain the dump, you can 
keep or catalog it on a direct access or 
tape unit. The last step in the pertinent 
job can serve several functions: to print 
out key data sets in steps that have been 
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abnormally terminated, to print an ABEND or 
SNAP dump stored in an earlier step, or to 
release a tape volume or direct access 
space acquired for dump data sets. 
Conditional execution of the last step can 
be established through proper use of the 
COND parameter and its subparameters, EVEN 
and ONLY, on the EXEC statement. 



Direct access space should be requested 
in units of average block size rather than 
in cylinders (CYL) or tracks (TRK) . If 
abnormal termination occurs and the data 
set is retained, the tape volume or direct 
access space should be released (DELETE in 
the DISP parameter) at the time the data 
set is printed. 







•Figure 22A. Sample of an ABEND Dump (PCP, MFT) 
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Figure 22B. Sample of an ABEND Dump (PCP, MFT) 
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Sample DD Statements : Figure 2 3 shows a 
set of job steps that include DD statements 
for ABEND dump data sets. 

The SYSABEND DD statement in STEP2 takes 
advantage of the direct access space 
acguired in STEP1 by indicating MOD in the 
DISP parameter. Note that the space 
request in STEPl is large so that the 
dumping operation is not inhibited due to 
insufficient space. The final SYSABEND DD 
statement in the job should indicate a 
disposition of DELETE to free the space 
acquired for dumping. 

Contents of an ABEND/SNAP Dump (PCP, MFT) 

This explanation of the contents of 
ABEND/SNAP dumps for systems with PCP and 



MFT is interspersed with sample sections 
taken from en AEENB dump. Capital letters 
represent tne headings found in all dumps, 
and lowercase letters, information that 
varies with each dump. The lowercase 
letter used indicates the mode of the 
information, and the number of letters 
indicates its length: 

o h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follow the explanation 
on your own ABEND or SNAP dump. 



















































































































































































■//STEP/ 


EXEC 


PGM=P 


ROGRA 


Mi 






















■//SYSABEf 


ID DD 


DSNAM 


E=DUM 


P,UUI 


T=23f 


/ ,DIS 


P=(,K 


EEP,K 


EEP)> 








* 




■// 




VOLUM 


E=SE^ 


M23«* 


,5PAC 


E« (TR 


K,(M 
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^^^^^H otK< 


it- DO s 
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■7/STEP2 


EXEC 


PGM=P 


ROGKA 


M2 






















■//SYSABE! 


ID DD 


DSNAM 


E»*.S 


TEPl. 


SYSAB 


END,D 


LSP^ 


MOD.D 


ELETE 


,KEEP 


), 




X 




■// 




V0L"R 


EF«*. 


STEP/ 


. SYSA 


BEND 
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Figure 23. SYSABEND DD Statements 
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***ABDUMP REQUESTED*** 
*ccccccc . , . 
JOB cccccccc STEP cccccccc TIME dddddd DATE ddddd 

COMPLETION CODE SYSTEM - hhh (or USER - dddd) 
cccccc . . . 

INTERRUPT AT hhhhhh 
PSW AT ENTRY TO ABEND (SNAP) hhhhhhhh hhhhhhhh 



PAGE dddd 



***AEDUMP REQUESTED*** 
identifies the dump as an ABEND or 

SNAP dump. 



♦ccccccc 

is omitted or is one or more of the 
following: 

*CORE NOT AVAILABLE, LOC. 

hhhhhhhhhhhh TAKEN . . . 

indicates that the ABDUMP routine 
confiscated storage locations 
hhhhhh through hhhhhh because not 
enough storage was available. 
This area is printed under P/P 
STORAGE, but can be ignored 
because the problem program 
originally in it was overlaid 
during the dumping process. 

♦MODIFIED, /SIRB/DEB/LLS/ARB/MSS. . . 
indicates that the one or more 
queues listed were destroyed or 
their elements dequeued during 
abnormal termination: 

• SIRB -- system interruption 
request block queue. One or 
more SIRB elements were found 
in the active RB queue: these 
elements are always dequeued 
during dumping. 

• DEB — DEB queue. If the first 
message also appeared, either a 
DEB or an associated DCB was 
overlaid. 

• LL3 — load list. If the first 
message also appeared, one or 
more loaded RBs were overlaid. 

• ARB — active RB queue. If the 
first message also appeared, 
one or moire RBs were overlaid. 

• MSS — boundary box queue. One 
or more MSS elements were 
dequeued, but an otherwise 
valid control block was found 



in the free area specified by 
an MSS element. 

♦FOUND ERROR IN /DEB/LLS/ARB/MSS . . . 

indicates that one or more of the 
following contained an error: 

• DEB: data extent block 

• LLS: load list 

• ARB: active RB 

• MSS: boundary box 

This message appears with either 
the first or second message 
above. The error could be: 
improper boundary alignment, 
control block not within storage 
assigned to the program being 
dumped, or an infinite loop (300 
times is the maximum for this 
test). For an MSS block, 4 other 
errors could also be found: 
incorrect descending sequence 
(omitting loop count) , 
overlapping free areas, free area 
not entirely within the storage 
assigned to the program being 
dumped, or count in count field 
not a multiple of 8. 

JOB cccccccc 

is the job name specified in the JOB 
statement. 

STEP cccccccc 

is the step name specified in the EXEC 
statement for the problem program 
being dumped. 

TIME dddddd 

is the hour (first 2 digits) , minute 
(second 2 digits), and second (last 2 
digits) when the ABDUMP routine began 
processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits) . For 
example, 67352 would be December 18, 
1967. 
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PAGE dddd 

is the page numoer. 
top of each page. 



Appears at the 



COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SY3TEM=hhh) or the 
problem program (USER=dddd) . Either 
SYSTEM=hhh or USER=dddd is printed, 
but not both. Common completion codes 
are explained in Appendix B. 

cccccc . . . 

explains the completion code or, if a 
program interruption occurred: 

PROGRAM INTERRUPTION CCCCC AT 

LOCATION hhhhhh, 

where ccccc is the program 
interruption cause — OPERATION, 
PRIVILEGED OPERATION, EXECUTE, 
PROTECTION, ADDRESSING, SPECIFICATION, 
DATE, FIXED- POINT OVERFLOW, 



FIXED-POINT DIVIDE, DECIMAL OVERFLOW, 
DECIMAL DIVIDE, EXPONENT 
OVERFLOW, EXPONENT UNDERFLOW, 
SIGNIFICANCE, or FLOATING- PCINT 
DIVIDE; and hhhhhh is the starting 
address of the instruction being 
executed when the interruption 
occurred. 



INTERRUPT AT hhhhhh 

is the address of next instruction to 
be executed in the problem program. 
It is obtained from tne resume PSW of 
the PRE or LPRB in the active RB queue 
at the time abnormal termination was 
requested. 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT tNTRY TO SNAF hhhhhhhh hhhhhhhh 

is the PSW for the problem or contrcl 
program that had control when abnormal 
termination was requested or when the 
SNAP macro instruction was executed. 



TCB 


hhhhhh RB 


hhhhhhhh PIE 


hhhhhhhh 


DEB hhhhhhhh TIOT 


hhhhhhhh 


CMP hhhhhhhh 


TRN hhhhhhhh 




M.SS 


hhhhhhhh PK/FLG hhhhhhhh 


FLG hhhhhhhh LLS 


hhhhhhhh 


JLB hhhhhhhh 


JST hhhhhhhh 




RG 0- 


-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 8- 


-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




FSA 


hhhhhhhh TCB 


hhhhhhhh 


TME hhhhhhhh PIB 


hhhhhhhh 


NTC hhhhhhhh 


OTC hhhhhhhh 




LTC 


hhhhhhhh IQE 


hhhhhhhh 


ECB hhhhhhhh XTCB 


hhhhhhhh 


LP/FL hhhhhhhh 


RESV hhhhhhhh 




STAE 


hhhhhhhh TCT 


hhhhhhhh 


USER hhhhhhhh DAR 


hhhhhhhh 


RESV hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 

is the starting address of the TCB. 

RB hhhhhhhh 

is the TCBRBP field (bytes through 
3) : starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue (usually 
ABEND'S RB). 

PIE hhhhhhhh 

is the TCBPIE field (bytes 4 through 
7) : starting address of the program 
interruption element (PIE) for the 

task. 

DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11) : starting address of the DEB 
queue. 

TIOT hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15): starting address of the TIOT. 

CMP hhhhhhhh 

is the TCBCMP field (bytes lt> through 
19) : task completion code in 



hexadecimal. System codes are shown 
in the third through fifth digits and 
user codes in the sixth through 
eighth. 

TRlM hhhhhhhh 

is the TCETRN field (bytes 20 through 
23) : starting address of control core 
(table) for controlling testinq of the 
task by TESTRAN. 

MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27): starting address of the main 
storage supervisor's boundary box. 

PK/FLG hhhhhhhh 

contains, in the first 2 digits, the 
TCBPKF field (byte 28): protection 
key. 

FLG hhhhhhhn 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS field 
(bytes 32 and 33): last 2 flag bytes. 

contains, in the next 2 digits, the 
TCBIMP field (byte 34): in systems 
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with PCP f both digits are zeros; in 
systems with MFT f number of resources 
on which the task is queued. 

contains, in the last 2 digits, the 
TCBDSP field (byte 35): 

• Reserved in PCP and MFT without 
subtasking; both digits are zero. 

• In MFT with subtasking, this field 
contains the dispatching priority of 
the TCB. 



LLS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39) : starting address of the RB 
most recently added to the load 
list. 



JLB hhhhhhhh 

is the TCBJLB field (bytes 40 through 
43) : starting address of the DCB 
for the JOBLIB data set. 



JST hhhhhhh 

is the TCB JST field (bytes 44 through 
47) . Not currently used in PCP or MFT 
without subtasking. In MFT with 
subtasking - the starting address of 
the TCB for the job step task. 



RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111) : contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in TCBs of tasks other 
than the task in control when the dump 
was requested. 



FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBIDF field (byte 112): TCE 
identifier field. 



contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115): 
starting address of the first problem 
program save area. This save area was 
set up by the control program when the 
job step was initiated. 



TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119): in systems with PCP, all digits 
are zeros; in systems with MFT, 
starting address of the next TCB of 
lower priority or, if this is the last 
TCB, zeros. 



TME hhhhhhhh 

is the TCBTME field (bytes 120 through 
123) : starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 
This field is not printed if the 
computer does not contain the timer 
option. 



PIE hhhhhhhh 

is the TCBPIB field (bytes 124 through 
127) : starting address of the program 
information block (MFT) or zeros 
(PCP) . 



NTC hhhhhhhh (printed only in MFT) 

is the TCBNTC field (bytes 128 throuqh 
131) : 

MFT without subtasking: zeros. 

MFT with suotasking: the starting 
address of the TCB for the previous 
subtask on this subtask TCB queue. 
This field is zero both in the job 
step task, and in the TCB for the 
first subtask created by a parent 
task. 



OTC hhhhhhhh (printed only in MFT) 

is the TCBOTC field (bytes 132 through 
135) : starting address of the TCB for 
the parent task. Both in the TCB for 
the job step task, and in MFT systems 
without subtasking this field is zero. 



LTC hhhhhhhh (printed only in MFT) 

is the TCBLTC field (bytes 136 through 
139) : starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in the TCB for a task that 
does not create subtasks. This field 
is always zero in an MFT system 
without subtasking. 



IQE hhhhhhhh (printed only in MFD 

is the TCBIQE field (bytes 140 through 
143). 

MFT without subtasking: zero. 

MFT with subtasking: starting address 
of the interruption queue element 
(IQE) for the ETXR exit routine. This 
routine is specified by the ETXR 
operand of the ATTACH macro 
instruction that created the TCB being 
dumped. The routine is to be entered 
when the task terminates* 
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ECB hhhhhhhh (printed only in MFT) 

is the TCBECB field (bytes 144 through 
147). 

MFT without subt asking: zero. 

MFT with sub-casking: starting address 
of the ECB field to ce posted by the 
control program at task termination. 
This field is zero if the task was 
attached without an ECB operand . 

XTCB hhhhhhhh (printed only in MFT) 
reserved for future use. 

LP/FL hhhhhhhh (printed only in MFT) 

MFT without subtasking: reserved. 

MFT with surrtasking: contains in the 
first byte, the limit priority of the 
task (byte 152). contains, in the 
last three bytes the field TCBFTFLG 
(bytes 153 through 155) - flag bytes. 



RESV hhhhhhhh (printed only in MFT) 
reserved for future use. 



STAE hhhhhhhh 

contains, in the first 2 diqits, STAE 
flags (ioyte 160) . 



contains, in the last 6 digits, the 
TCENSTAE field (bytes 161 through 
163) : starting address of the current 
STAE control block for the task. This 
field is zero if STAE has not ceen 
issued. 



TCI hhhhhhhh 

is the TCBTCT field (bytes 164 through 
lb7) : 



ICP: ^eros 



MFT: Address of the Timing Control 

Table (TCT) Zeros of the System 
Management Facilities option is 
not present in the system. 



USER hhhhhhhn 

is the TCEUSER field (bytes 168 
through 171) : to be used as the user 
chooses . 

DAR hhhhhhhh 

contains, in the first 2 digits. 
Damage Assessment Routine (DAR) flags 
(byte 172) ; 

MFT only, contains, in the last 6 
diqits, tne secondary 
non-dispatchability bits (bytes 173 
through 17b) . 

RESV hhhhhhhh 

reserved for future use. 

JSCB hhhhhhhh 

is the TCEJSCB field (bytes 180 
through 183): the last three bytes 
contain the address of the Job Step 
Control Block. 



ACTIVE RBS 












cccc hhhhhh 


NM cccccccc SZ/STAB hhihhhtih 


USE/EP hhhhhhhh PSW 


hhhhhhhh hhhhhhhh 


hhhhhh WT, 


LNK hhhhhhhh 




RG 0-7 hhhhhhhh hhhhnhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




RG 8-15 hhhhhhhh hhhh ihhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 



ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB. 



SIRB Supervisor interrupt request 
block 

IPRE Loaded program request block 



cccc hhhhhh 

indicates the RB type and its starting 
address. 



The RB types are: 

PRB Program request block 



IRB Interruption request block 

SVRB Supervisor request block 

NM xxxxxxxx 

is the XRBWM field (bytes through 
7): in FRB, LRE , and LPRB, the 
program name; in IRB, the first byte 
contains flags for the timer or, if 
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the timer is not being used, contains 
no meaningful information; in SVRB for 
a type 2 SVC routine, the first 4 
bytes contain the TTR of the load 
module in the SVC library, and the 
last 4 bytes contain the SVC number in 
signed, unpacked decimal. 

SZ/STAB hhhhhhhh 

contains in the first 4 digits, the 
XRBSZ field (bytes 8 and 9): number 
of contiguous doublewords in the RB, 
the program (if applicable), and 
associated supervisor work areas. 

contains in the last 4 digits, the 
XSTAB field (bytes 10 and 11): flag 
nytes . 

USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12) : use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 13 through 15): 
address of entry point in the 
associated program. 

PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes 16 through 
23) : resume PSW. 



Q hhhhhh 

is the last 3 bytes of the XRBC. field 
(bytes 25 through 27): in PRB and 
LPRE, starting address of an LPRB for 
an entry identified by an IDENTIFY 
macro instruction; in IRB, starting 
address of a reguest element; in SVRB 
for a type 3 or 4 SVC, size of the 
program in bytes. 



WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 
XRBWT field (byte 28): wait count. 



contains, in the last 6 digits, the 
XRBLNK field (bytes 29 through 31): 
primary queuing field. It is the 
starting address of the previous RB 
for the tasx or, in the first RB to be 
placed on the queue, the starting 
address of the TCB. 



RG 0-7 and RG 8-15 

is the XRBREB field (bytes 32 through 
95 in IRBs and SVRBs) : contents of 
general registers through 15 stored 
in the RB. These 2 lines do not 
appear for PRBs, LPRBs, and LREs. 



LOAD LIST 

cccc hhhhhh NM cccccccc SZ/STAB hhhhhhhh USE/EP hhhhhhhh PSW hhhhhhhh hhhhhhhh Q hhhhhh WT/LNK hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list queued to 
the TCB. 



cccc hhhhhh 

indicates the RB type and its starting 
address. 



SZ/STAB hhhhhhhh 

contains, in the first 4 digits, the 
XRBSZ field (bytes 8 and 9): 
number of contiguous 
doublewords for the RB, the 
program (if applicable) , and 
associated supervisor work 
areas. 



The RB types are: 

LRB Loaded request block 
LPRB Loaded program request block 
D-LPRB Dummy loaded program request 
block. (Present if the 
resident reenterable lead 
module option was selected in 
MFT) . 



NM cccccccc 

is the XRBNM field (bytes through 
7) : program name. 



contains, in the last 4 digits, the 

XSTAB field (bytes 10 and 11) 
flag bytes. 



USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12): use 
count. 

contains, in the last 6 digits, the 

XRBEP field (bytes 12 through 
15) : address of entry point 
in the program. 
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PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes lb through 
23) : resume PSW. 

y hhhhhh 

is the last 3 bytes of the XRBG field 
(bytes 2 5 through 27) : in 
LPRB, starting address of an 
1-.PRB for an entry identified 
by an IDENTIFY macro 
instruction; in LRB, unused. 

WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 



XRBWT field (byte 28): 
count. 



wait 



contains, in the last b digits, the 

XRELNK field (bytes 29 through 
31) : primary queuing field 
for LRBs and LPRBs also on the 
active RB queue. It points to 
the previous RB for the task 
or, in the oldest RB in the 
queue, back to the TCB. 






JOB PACK AREA QUEUE 






















cccc hhhhhh NM cccccccc 


SZ/STAB 


hhhhhhhh 


USE/EP 


hhhhhhhh 


PSW 


hhhhhhhh 


hhhhhhhh Q hhhhhh 


WT/LNK 


hhhhhhhh 




cccc hhhhhh NM cccccccc 


SZ/STAB 


hhhhhhhh 


WTL 


hhhhhhhh 


REQ 


hhhhhhhh 


TLPRB hhhhhhhh 








cccc hhhhhh NM cccccccc 


SZ/STAB 


hhhhhhhh 


USE/EP 


hhhhhhhh 


PSW 


hhhhhhhh 


hhhhhhhh Q hhhhhh 


WT/LNK 


hhhhhhhh 





JOB PACK AREA QUEUE (MFT with subtasking 

only) 

identifies the next lines as the 
contents of the job pack area gueue 
originating in the partition 
information block (PIB) . 

cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

FRB Finch request block 

LRB Loaded reguest block 

LPRB Loaded program request block 

NM cccccccc 

is the XRBNM field (bytes through 
7) : Program name. 

SZ/STAB hhhhhhhh 

contains, in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords for the RB, 
the program (if applicable) , and 
associated supervisor work areas. 

contains, in the last 4 digits, the 
XSTAB field (byte's 10 and 11) : flag 
bytes . 

USE/EP hhhhhhhh (LPRB, LRB Only) 

contains, in the first 2 digits, the 
XRBUSE field (byte 12): use count. 

contains, in the last b digits, the 
XRBEP field (bytes 13 through 15) : 
address of entry point in the program. 

WTL hhhhhhhh (FRB Only) 

is tne XRWTL field of the FRB (bytes 



12 through 15) : address of the most 
recent wait list element (WLE) on the 

WLL gueue. 



PSW hhhhhhhh hhhhhhhh (LPRB, LRB Only) 

is the XRBPSW field (bytes 16 through 
2 3) : resume PSW. 



REG hhhhhhhh (FRB Only) 

is the XRRSQ field of the FRB (bytes 
lb through 19): address of the TCE of 
the requesting task. 

TLPRB hhhhhhhh (FRB Only) 

is the XRTLPRB field of the FRB (oytes 
20 through 23) : address of the LPkB 
built by the Finch routine for the 
reguested program. 

Q hhhhhh (LRB, LFRB Only) 

is the last 3 bytes of the XRBG field 
(bytes 25 through 27): 

• in an LPRB, the starting address of 
an LPRB for an entry identified by 
an IDENTIFY macro instruction. 

• in an LRB, unused. 

WT/LNK hhhhhhhh (LRB, LPRB Only) 

contains, in the first 2 digits, the 
XRBVvT Eield (byte 28): wait count. 

contains, in the last 6 digits (bytes 
29 through 31) : primary queuing field 
for RBs. These RBs may be queued 
either on tne job pack area queue or 
on the active RB queue. It points to 
the previous RB for the task or, in 
tne oldest RB on the queue, back tc 
the TCB. 
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P/P STORAGE 


BOUNDARIES hhhhhhhh TO hhhhhhhh 










FREE AREAS 


SIZE 










hhhhhh 


hhhhhhhh 










GOTTEN CORE 


SIZE 










hhhhhh 


hhhhhhhh 










SAVE AREA TRACE 










ccccoccc WAS 


ENTERED VIA LINK (CALL) ddddd AT EP coccc. 










SA hhhhhh 


WD1 hhhhhhhh HSA hhhhhhhh LSA hhhhhhhh 


RET hhhhhhhh 


EPA hhhhhhhh 


RO 


hhhhhhhh 




Rl hhhhhhhh R2 hhhhhhhh R3 hhhhhhhh 


R4 hhhhhhhh 


R5 hhhhhhhh 


R6 


hhhhhhhh 




R7 hhhhhhhh R8 hhhhhhhh R9 hhhhhhhh 


RIO hhhhhhhh 


Rll hhhhhhhh 


R12 


hhhhhhhh 


INCORRECT BACK CHAIN 










PROCEEDING BACK VIA REG 13 











P/P STORAGE BOUNDARIES hhhhhhhh TO hhhhhhhh 
gives the addresses of the lower and 
upper boundaries of a main storage 
area assigned to the task. This 
heading is repeated for every 
noncontiguous block of storage owned 
by the task. 



FREE AREAS 



hhhhhh 



SIZE 



hhhhhh 



CCCCCCCC WAS ENTERED 

is the name of the program that stored 
register contents in the save area. 
This name is obtained from the RB. 



VIA LINK (CALL) ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 
operand, if it was specified, of the 
LINK or CALL macro instruction. 



hhhhhh hhhhhh 

are the starting addresses of free 
areas and the size, in bytes, of each 
area contained within the P/P STORAGE 
BOUNDARIES field listed above. 

GOTTEN CORE SIZE 

hhhhhh hhhhhhhh 



hhhhhh hhhhhhhh 

(Printed only in a dump of a system 
with the MFT with subtasking option) . 
These figures represent the starting 
addresses of the gotten areas (those 
areas obtained for a subtask through a 
supervisor issued GETMAIN macro 
instruction), and the size, in bytes, 
of each area contained within the P/P 
STORAGE BOUNDARIES field listed above. 
If main storage hierarchy support is 
included in the system, the values in 
this field can address storage in 
either hierarchy or hierarchy 1, or 
both. 

SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 



AT EP ccccc 

is the entry point identified, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area. 

SA hhhhhn 

is the starting address of the save 
area. 

WD1 hhhhhhhh 

is the first word of the save area: 
use of this word is optional. 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In the 
first save area in a job step, this 
word contains zeros. In all other 
save areas, tnis word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 
(register 13) : starting address of 
the save area in the next lower level 
module. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14): return address. 
Optional. 
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EPA hhhhhhhh 

is the fifth word of the save area 
(register 15) : entry point to the 
invoked module. Optional. 

RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12): 
contents of registers through 12 
immediately after the linkage for the 
module containing the save area. 

INCORRECT BACK CHAIN 

indicates that the following lines may 
not be a save area because the second 



word in this area does not point back 
to the previous save area in the 
chain. 



PROCEEDING BACK VIA REG 13 

indicates that the next 2 save areas 
are (1) tne save area in the lowest 
level module, followed by (2) the save 
area in the next higher level module. 
The lowest save area is assumed to be 
the save area pointed to by register 
13. These 2 save areas appear only if 
register 13 points to a full word 
boundary and does not contain zeros. 



DATA SETS 










*****NOT FORMATTED***** 










cccccccc UCB ddd hhhhhh 


DEB 


hhhhhh 


DCB 


hhhhhh 


**D/S FORMATTING TERMINATED** 











DATA SETS 

indicates that the next lines present 
information about the data sets for 
the task. For unopened data sets, 
only the ddname and UCB information 
are printed. 

NOT FORMATTED 

indicates that the abnormal 
termination dump routine confiscated 
storage (indicated Jay *CORE NOT 
AVAILABLE, LOC . hhhhhh-hhhhhh TAKEN); 
because DCBs may have been overlaid, 
data set information is not presented. 

cccccccc 

is the name field (ddname) of the DD 
statement . 

UCB ddd hhhhhh 

is the unit to which the data set was 



assigned, and the starting address of 
the UCB for that unit. If the data 
set was assigned to several units, the 
additional units are identified on 
following lines. 

DEa hhhhhh 

is the starting address of the DEB for 
the data set. Appears only for open 
data sets . 

DCB hhhhhh 

is the starting address of the DCB for 
the data set. Appears only for open 
data sets . 

**D/S FORMATTING TERMINATED** 

indicates that no more data set 
information is presented because a DCB 
is incorrect, possibly because a 
program incorrectly modified it. 
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TRACE 


TABLE - STARTING WITH OLDEST 


ENTRY 














dddd 


I/O ddd PSW hhhhhhhh 


hhhhhhhh 






CSW 


hhhhhhhh 


hhhhhhhh 




dddd 


SIO ddd CC = d 




CAW 


hhhhhhhh 


OLD CSW 


hhhhhhhh 


hhhhhhhh 


(or CSW STATUS hhhh) 


dddd 


SVC ddd PSW hhhhhhhh 


hhhhhhhh 


RG 


hhhhhhhh 


RG 1 


hhhhhhhh 







TRACE TABLE — STARTING WITH OLDEST ENTRY 
identifies the next lines as the 
contents of the trace table. Each 
entry is presented on one line. The 
types of entries are: 



I/O Input/output interruption entry 



SIO Start input/output (SIO) entry 

SVC Supervisor call (SVC) interruption 
entry 



dddd 



is the number assigned to each entry. 
The oldest entry receives the number 
0001. 



CC=d 

is the condition code resulting from 
execution of the SIO instruction. 
Zero indicates a successful start. 

CAW hhhhhhhh 

is the channel address word used by 
the SIC instruction. 

OLD CSW hhhhhhhh hhhhhhhh 

is the channel status word stored 
during execution of an SIO operation. 
It appears when CC is not equal to 1. 

CSW STATUS hhhh 

is the status portion of the channel 
status word stored during execution of 
an SIO instruction. Appears when CC 
is equal to 1. 



I/O ddd 

is the channel and unit that caused 
the input/output interruption. 



PSW hhhhhhhh hhhhhhhh 

is the program status word that was 
stored when the input/output 
interruption occurred. 

CSW hhhhhhhh hhhhhhhh 

is the channel status word that was 
stored when the input/output 
interruption occurred. 

SIO ddd 

is the device specified in the SIO 
instruction. 



SVC ddd 

is the SVC instruction's operand. 



PSW hhhhhhhh hhhhhhhh 

is the PSW stored during the SVC 
interruption. (After release 11, an F 
in the fifth digit of the first word 
identifies the entry as representing a 
task switch.) 

RG hhhhhhhh 

is the contents of register as 
passed to the SVC routine. 

RG 1 hhhhhhhh 

is the contents of register 1 as 
passed to the SVC routine. 
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REGS 


AT ENTRY TO ABEND (SNAP) 








FLTR 


0-6 hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


REGS 


0-7 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


REGS 


8-X5 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 



REGS AT ENTRY TO ABEND or REGS AT ENTRY TO 

SNAP 

identifies the next 3 lines as the 
contents of the floating point and 
general registers when the abnormal 
termination routine received control 
in response to an ABEND macro 
instruction or when the SNAP routine 
received control in response to a SNAP 
macro instruction. 



FLTR 0-6 



is the contents of floating point 
registers f 2, U f and b. 



REGS 0-7 



is the contents of general registers 
throuah 7 . 



REGS 8-15 



is the contents of general registers 
tnrough lb. 



NUCLEUS 


















hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*ccccccccoccccccccccoccccccococcc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*ccccccccccccccccccoccccccccccccc* 


LINE 


hhhhhh SAME AS ABOVE 














hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccocccccccc* 


LINES 


hhhhhh-hhhhhh 


SAME A£ 


ABOVE 












hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*ccccccoccccccccccccccccccccccccc* 


P/P STORAGE 
















hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*ccccoccccccccocccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*ccccccccccccccocccccccccccccoccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


LINES 


hhhhhh-hhhhhh 


SAME AS ABOVE 












hhhhhh 


hhhhhhhh hhhhhhhh 
END OF DUMP 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


•ccccccccoccccccccccccccccccccccc* 



The content of main storage is given 
under 2 headings: NUCLEUS and P/P STORAGE. 
Under these headings, the lines have the 
following format: 

• First entry: the address of the 
initial byte of main storage contents 
presented on the line. 

• Next 8 entries: 8 full words (32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks) : 
the same 8 full words of main storage 
in EBCDIC. Only A through Z, through 
9 , and blanks are printed; a period is 
printed for anything else. An 
exception occurs in the printed lines 
representing the ABDUMP work area. The 
contents of the ABDUMP work area during 
the printing of EBCDIC characters 



differs from the contents durino 
printing of the hexadecimal characters 
because a portion of the work area is 
used to write lines to the printer. 
This exception should not create any 
problems since the contents of the 
AEDUMP work area is of little use in 
debugging . 

The following lines may also appear: 

LINES hhhhhhhh-hhhhhhhh SAME AS ABOVE 
are the starting addresses of the 
first and last line of a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 
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NUCLEUS 

identifies the next lines as the 
contents of the control program 
nucleus. 

P/P STORAGE 

identifies the next lines as the 
contents of the main storage area 
assigned to the task (problem 
program) . 

END OF DUMP 

indicates that the dump or snapshot is 
completed. 



Load List and Jo& Pack Area Queue ; The 
load module that had control at the time of 
abnormal termination may not contain the 
instruction address pointed to by the 
resume PSW. In that case, look at the RBs 
on the load list and on the job pack area 
queue (MFT with subtasking) . Compare the 
instruction address with the entry points 
of each load module (shown in the last 3 
bytes of the field labeled USE/EP) . The 
module which contains the instruction 
pointed to by the resume PSW is the one in 
which abnormal termination occurred. The 
name of the load module is indicated in the 
field labeled NM. 



Guide to Using an ABEND/SNAP Dump (PCP, 
MFT) 

Cause of Abnormal Termination : Evaluate 
the user (USER Decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix B or the publication Messages and 
Codes . 

Active RB Queue ; The first RB shown on the 
dump represents the oldest RB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last RB 
represents the ABDUMP routine, and the 
second from last, the ABEND routine. The 
names of load modules represented in the 
active RB queue are given in the RB field 
labeled NM in the dump. Names of load 
modules in SVC routines are presented in 
the format: 



NM 



SVC-mnnn 



where m is the load module number (minus 1) 
in the routine and nnn is the signed 
decimal SVC number. The last two RBs on an 
ABEND/SNAP dump will always be SVRBs with 
edited names SVC-105A (ABDUMP— SVC 51) and 



SVC-401C (ABEND — SVC 13). 



Resume PSW ; The resume PSW field is the 
fourth entry in the first line of each RB 
printout. It is identified by the 
subheading PSW. For debugging purposes, 
the resume PSW of the third RB from the 
bottom, on the dump, is most useful. The 
last three characters of the first word 
give the SVC number or the I/O device 
address, depending on which type of 
interruption caused the associated routine 
to lose control. It also provides the CPU 
state at the time of the interruption (bit 
lb) , the length of the last instruction 
executed in the program (bits 32,33), and 
the address of the next instruction to be 
executed (bytes 5-8) . 



Trace Table ; Entries in the trace table 
reflect SIO, I/O, and SVC interruptions. 
SIO entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. 

I/O entries reflect the I/O old PSW and 
the CSW that was stored when the 
interruption occurred. From the PSW, you 
can learn the address of the device on 
which the interruption occurred (bytes 2 
and 3), the CPU state at the time of 
interruption (bit 15), and the instruction 
address where the interruption occurred 
(bytes 5-8) . The CSW provides you with the 
unit status (byte 4) , the channel status 
(byte 5) , and the address of the previous 
CCW plus 8 (bytes 0-3) . 

SVC entries provide the SVC old PSW and 
the contents of registers and 1. The PSW 
offers you the hexadecimal SVC number (bits 
20-31), the CPU mode (bit 15), and the 
address of the SVC instruction (bytes 5-8) . 
The contents of registers and 1 are 
useful in that many system macro 
instructions use these registers for 
parameter information. Contents of 
registers and 1 for each SVC interruption 
are given in Appendix A. 

Not e; If an ABEND macro instruction is 
issued by the system when a program check 
interruption causes abnormal termination, 
an SVC entry does not appear in the trace 
table, but is reflected in the PSW at entry 
to ABEND. 

Free Areas ; ABEND/SNAP dumps do not print 
out areas of main storage that are 
available for allocation. Since the ABLND 
routine uses some available main storage, 
the only way you can determine the amount 
of free storage available when abnormal 
termination occurred is to re-create the 
situation and take a stand-alone dump. 
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MET Considerations ; : Dumps issued by 
systems with MFT include an additional 
trace table entry for task switches. This 
entry looks similar to an SVC entry, except 
that words 3 and 4 of the entry contain the 
address of the TCBs for the "new" and "old" 
tasks being performed, respectively. The 
trace table entries for one particular task 
are contained between sets of two task 
switch entries. Word 3 of the beginning 
task switch entry and word 4 of the ending 
task switch entry point to the TCB for that 
task. With release 11 and following 



releases, task switch entries are 
identified by a fifth digit of * F' 



Not e: To find all the entries for the 
terminated task, on a dump issued prior to 
release 11, obtain the TCB addresses under 
the TCE heading of the dump and scan the 
trace table under words 3 and 4 for these 
addresses. Then enclose the areas that 
begin with an entry having the TCB address 
in word 3, and end with an entry having the 
same TCB address in word 4. If words 3 and 
4 contain the same address, disregard the 
tasjc switch entry. 
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ABEND/SNAP Dump 
(Systems With MVT) 



MVT dumps differ from PCP and MFT dumps in 
the addition of detailed main storage 
control information, the omission of a 
complete main storage dump, and the 
omission of a trace table in ABEND dumps. 
MVT dumps occur immediately after an 
abnormal termination, provided an AEEND or 
SNAP macro instruction was issued and 
proper dump data sets were defined. 
However, if a system failure has occurred 
and a SYS1.DUMP data set has been defined 
and is available, a full core image dump is 
provided, as explained in the section 
headed "Core Image Dump." 



With iMVT's subtask creating capability, 
you may receive one or more partial dumps . 
in addition to a complete dump of the task 
that caused abnormal termination. A 
complete dump includes all control 
information associated with the terminating 
task and a printout of the load modules and 
subpools used by the task. A partial dump 
of a task related to the terminating task 
includes only control information. A 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump. Figure 24 shows the key areas of a 
complete dump. 



MVT Considerations : In specifying a region 
size for a job step subject to abnormal 
termination, you must consider the space 
requirements for opening a SYSABENE or 
SYSUDUMP data set (if there is one), and 
loading the AEDUMP routine and required 
data management routines. This space 
requirement can run as high as 6000 bytes. 



Direct access devices are used 
frequently for intermediate storage of dump 
data sets in systems with MVT. To use 
direct access space efficiently, the space 
for the dump data set should be varied, 
depending on whether or not abnormal 
termination is likely. A small quantity 
should be requested if normal termination 
is expected. To prevent termination of the 
dump due to a lack of direct access space, 
always specify an incremental (secondary) 
quantity when coding a SPACE parameter for 
a dump data set. You can obtain a 
reasonable estimate of the direct access 
space required for an ABEND/SNAP dump by 
adding, (1) the number of bytes in the 
nucleus, (2) the part of the system queue 
space required by the task (9150 bytes is a 
sufficient estimate) , and (3) the amount of 
region space occupied by the task. 
Multiply the sum by 4, and request this 
amount of space in 1024-byte blocks. 



In systems with MVT, you can effect 
termination of a job step task upon 
abnormal termination of a lower level task. 
To do this, you must either terminate each 
task upon finding an abnormal termination 
completion code issued by its subtask or 
pass the completion code on to the next 
higher level task. 



Invoking an ABEND/SNAP Dump (MVT) 

ABEND/SNAP dumps issued by systems with MVT 
are invoked in the same manner as those 
under systems with PCP and MFT. They 
result from an ABEND or SNAP macro 
instruction in a system or user program, 
accompanied by a properly defined data set. 
In the case of a system failure, the Damage 
Assessment routine (DAR) attempts to write 
a core image dump to the SYS1.DUMP data 
set. A full explanation of core image 
dumps may be found in the section headed 
"Core Image Dump." The instructions that 
invoke an ABEND/SNAP dump in MVT 
environment are the same as those given in 
the preceding topic for systems with PCP 
and MFT. However, some additional 
considerations must be made in requesting 
main storage and direct access space. 



This formula gives the space 
requirements for one task. Request 
additional space if partial dumps of 
subtasks and invoking tasks will be 
included. 



Contents of an ABEND/SNAP Dump (MVT) 

This explanation of the contents of 
ABEND/SNAP dumps issued by systems with MVT 
is interspersed with sample sections from 
an ABEND dump. Capital letters represent 
the headings found in all dumps, and 
lowercase letters, information that varies 
with each dump. The lowercase letter used 
indicates the mode of the information and 
the number of letters indicates its length: 

« h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follow the explanation on 
your own AEEND or SNAP dump. 
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JOB cccccccc 


STEP cccccccc TIME dddddd 


DATE ddddd 


ID 


- ddd 


PAGE dddd 


COMPLETION CODE 


SYSTEM - hhh (or USER - dddd) 










PSW AT ENTRY TO 


ABEND (SNAP) hhhhhhhh hhhhhhhh 











JOB CCCCCCCC 

is the job name specified in the JOB 
statement. 

STEP cccccccc 

is the step name specified in the EXEC 
statement for the problem program 
associated with the task being dumped. 

TIME dddddd 

is the hour (first 2 digits), minute 
(next 2 digits), and second (last 2 
digits) when the abnormal termination 
dump routine began processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits) . For 
example, 67352 would be December 18, 
1967. 

ID=ddd 

is an identification of the dump. For 
dumps requested by an ABEND macro 
instruction, this identification is; 

• Absent if the dump is of the task 
being abnormally terminated. 

• 001 if the dump is of a subtask of 
the task being abnormally 



terminated. (Note that, when a task 
is abnormally terminated, its 
subtasks are also abnormally 
terminated. ) 

• 002 if the dump is of a task that 
directly or indirectly created the 
task being abnormally terminated* up 
to and including the job step task. 

PAGE dddd 

is the page number. Appears at the 
top of each page. Page numbers begin 
at 0001 for each task or subtask 

dumped . 

COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd) . 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT ENTRY TO snap hhhhhhhh hhhhhhhh 

is the PSW for the problem program or 
control program routine that had 
control when abnormal termination was 
reguested, or when the SNAP macro 
instruction was executed. It is not 
necessarily the PSW at the tiire the 
error condition occurred. 



TCB hhhhhh 


RBP hhhhhhhh PIE 


hhhhhhhh 


DEB hhhhhhhh TIO hhhhhhhh CMP 


hhhhhhhh 


TRN hhhhhhhh 




MSS hhhhhhhh PK-FLG hhhhhhhh 


FLG hhhhhhhh LLS hhhhhhhh JLB 


hhhhhhhh 


JPQ hhhhhhhh 




RG 0-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 8-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




FSA hhhhhhhh TCB 


hhhhhhhh 


TME hhhhhhhh JST hhhhhhhh NTC 


hhhhhhhh 


OTC hhhhhhhh 




LTC hhhhhhhh IQE 


hhhhhhhh 


ECB hhhhhhhh STA hhhhhhhh D-PQE 


hhhhhhhh 


SOS hhhhhhhh 




NSTAE hhhhhhhh TCT 


hhhhhhhh 


USER hhhhhhhh DAR hhhhhhhh RESV 


hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 



PIE hhhhhhhh 



is the starting address of the TCB . 



RBP hhhhhhhh 

is the TCBRBP field (bytes through 
3) : starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue. 



is the TCBPIE 
7) : starting 
interruption e 
task; however, 
termination du 
the abnormal t 
field is zeroe 
to prevent int 
dumpirr- 



field (bytes 4 through 
address „f the program 
lement (PIE) for the 

in an abnormal 
mp for the task causing 
ermination, zeros. The 
d by the ABEND routine 
erruptions during 
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DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11) : starting address of the DEB 
queue. Under the heading DEB in the 
dump, the prefix section for the first 
DEE in the queue is presented in the 
first 8-digit entry on the first line. 
The 6-digit entry at the left of each 
line under DEB is the address of the 
second column on the line, whether or 
not the column is filled. 



LLS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39) : starting address of the load 
list element most recently added to 
the load list. 



JLB hhhhhhhh 

is the TCBJLB field (bytes 4 through 
43) : starting address of the DCB for 
the JOBLIB data set. 



TIO hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15) : starting address of the TIOT. 

CMP hhhhhhhh 

is the TCBCMP field (bytes 16 through 
19) : task completion code or contents 
of register 1 when the dump was 
requested. System codes are given in 
the third through fifth digits and 
user codes in the sixth through eight 
digits. 

TRN hhhhhhhh 

is trie TCBTRN field (bytes 20 through 
23) : starting address of the control 
core (table) for controlling testing 
of the task by TESTRAN. 

MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27): starting address of SPQE most 
recently added to the SPQE queue. 

PK-FLG hhhhhhhh 

contains, in the first 2 digits, the 

TCBPKF field (byte 28): protection 

key. 

contains, in the last 6 digits, the 
first 3 bytes of the TCBFLGS field 
(bytes 29 through 31): first 3 flag 
bytes. 



FLG hhhhhhhh 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS (bytes 32 
and 33): last 2 flag bytes. 



contains, in the next 2 digits, the 

TCBLMP field (byte 34) : limit 
priority (converted to an internal 
priority, to 2 55). 

contains, in the last 2 digits, the 
TCBDSP field (byte 35) : dispatching 
priority (converted to an internal 
priority, to 255) . 



JPQ hhhhhhhh 

is the TCBJFQ field (bytes 41 through 
47) : when translated into binary 

bits: 

• Bit is the purge flag. 

• Bits 1 through 7 are reserved for 
future use and are zeros. 

• Bits 8 through 31 are the starting 
address of the queue of CDEs for the 
job pack area control queue, which 
is for programs acquired by the job 
step. 

The TCBJPQ field is used only in the 
first TCB in the job step; it is zeros 
for all other TCBs . 

RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111) : contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in dumps of tasks other 
than the task in control when the dump 
was requested. 

FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBQEL field (byte 112) : count of 
enqueue elements. 

contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115) : 
starting address of the first problem 
program save area. This save area was 
set up by the control program when the 
job step was initiated. 

TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119) : starting address of the next 
lower priority TCB on the TCB queue 
or, if this is the lowest priority 
TCB, zeros. 

TME hhhhhhhh 

is the TCBTME field (bytes 120 through 
123) : starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 



ABEND/SNAP Dump (Systems with MVT) 53 



JST hhhhhhhh 

is the TCBJSTCB field (bytes 124 
through 127): starting address of the 
TCB for the job step task. For tasks 
with a protection key of zero, tiiis 
field contains the starting address of 
the TCB. 



D-PQE hhhhhhhh 

is the TCBFQE field (bytes 152 through 
155) : starting address minus 8 bytes 
of the dummy VQE. This field is 
passed by the ATTACH macro instruction 
to each TCB in a job step. 



NTC hhhhhhhh 

is the TCBNTC field (bytes 128 through 
131) : the starting address of the TCB 
for the previous subtask on this 
subtask queue. This field is zero in 
the job step task, and in the TCL for 
the first subtask created by a parent 
task. 

OTC hhhhhhhh 

is the TCBOTC field (bytes 132 through 
135) : starting address of TCB for the 
parent task. In the TCB for the job 
step task, this field contciins the 
address of the initiator. 



LTC hhhhhhhh 

is the TCBLTC field (bytes 136 through 
139): starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in a TCB for a task that does 
not create subtasks . 



SQS hhhhhhhh 

is the TCEAQE field (bytes 156 through 
159): starting address of the 
allocation queue element (AQE) . 



NSTAE hhhhhhhh 

contains, in the first 2 digits, STAE 
flags (byte 160) . 



contains, in the last 6 digits, the 
TCBNSTAE field (bytes 161 through 
163) : starting address of the current 
STAE control block for the task. This 
field is zero if STAE has net neen 
issuer* 



TCT hhhhhhhh 

is the TCBTCT field (bytes 164 through 
167) : address of the liming Control 
Table (TCT) . 



™^^^" : i, 



IQE hhhhhhhh 

is the TCBIQE field (bytes 140 through 
143) : starting address of the 
interruption queue element (IQE) for 
the ETXR exit routine. This routine 
is specified by the ETXR operand of 
the ATTACH macro instruction that 
created the TCB being dumped. The 
routine is to be entered when the task 
terminates . 



ECB hhhhhhhh 

is tne TCBECB field (bytes 144 through 
147) : starting address of the ECB to 
be posted by the control program at 
task termination. This field is zero 
if the task was attached without an 
ECB operand. 



STA hhhhhhhh 

contains zeros, reserved for future 
use. 



USER hnhhhhhh 

is the TCBUSER field (bytes 168 
throuqh 171): to be used as the user 
chooses . 



DAR hhhhhhhh 

contains, in the first two diqits, 
Dan age Assessment Routine (DAR) flags 
(byte 172); 

MET only, contains, in the last 6 
diqits, the secondary 
non-dispatcnabiiity bxts (bytes 17 3 
tnrough 17s) . 

RESV hhhhhhhh 

reserved for future use. 

JSCB hhhhhhhh 

is the TCBJSCB field (bytes 18 
tnrough 183): the last three bytey 
contain the address of the Job Step 
Control Block. 
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ACTIVE RBS 














cccc hhhhhh 


cccccc 


hhhhhhhh 


APSW hhhhhhhh WC-SZ- 


STAB hhhhhhhh 


cccccc h 




Q/TTR 


hhhhhhhh 


WT-LNK hhhhhhhh 








RG 0-7 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




RG 8-15 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




EXTSA 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 






hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 





lhhhh PSW hhhhhhhh hhhhhhhh 

hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh 



ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB, beginning with the oldest RB 
first. 

cccc hhhhhh 

indicates the RB type (cccc) and 
starting address (hhhhhh). 

The RB types are: 

PRB program request block 

IRB interruption request block 

SVRB supervisor request block 

cccccc hhhhhhhh 

indicates the RB's function (cccccc) 
and bytes throuqh 3 of the RB 
(hhhhhhhh) : 

• RESV hhhhhhhh indicates PRB or SVRB 
for resident routines. Bytes 
through 3 are reserved for later use 
and contain zeros. 

• TAB-LN hhhhhhhh indicates SVRE for 
transient routines. The first 4 
digits contain the RBTABNO field 
(bytes and 1): displacement from 
tne beginning of the transient area 
control table (TACT) to the entry 
for the module represented by the 
RB. The last 4 digits contain the 
RBRTLNTH field (bytes 2 and 3): 
length of the SVC routine. 

• FL-PSA hhhhhhhh indicates IRB. Tne 
first 2 digits contain the RBTMFL.O 
field (byte 0) : indicators for the 
timer routines. This byte contains 
zeros when the IRE does not 
represent a timer routine. The last 
6 digits contain the RBPSAV field 
(bytes 1 through 3): starting 
address of the problem program 
register save area (PSA) . 



APSW hhhhhhhh 

is the REABOPSW field (bytes 4 through 
7): 



• In PRB f right half of the problem 
program's PSW when the interruption 
occurred. 

• In IRB or SVRB for type II SVC 
routines, right half of routine's 
PSW during execution of AEEND or 
AETERM, or zeros. 

• In SVRE for type III or IV SVC 
routines, right half of routine's 
PSW during execution of ABEND or 
AETERM, or the last four characters 
of the name of the requested 
routine. (The last two characters 
give the SVC number.) 



WC-SZ-STAE hhhhhhhh 

contains, in the first 2 digits, the 
REWCSA field (byte 8) : wait count in 
effect at time of abnormal termination 
of the program. 

contains, in the second 2 digits, the 
RESIZE field (byte 9): size of the RB 
in doublewords. 

contains, in the last 4 digits, the 
RESTAB field (bytes 10 and 11): 
status and attribute bits. 



cccccc hhhhhhhh 

indicates the RB's function (cccccc) 
and bytes 12 through 15 of the RB 
(hhhhhhhh): 

• FL-CDE hhhhhhhh indicates SVRB for 
resident routines, or PRB. The 
first 2 digits contain the RBCDFLGS 
field (byte 12): control flags. 
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The last 6 digits contain the RBCDE 
field (bytes 13 through 15): 
starting address of the CDE for the 
module associated with this RB. 

• EPA hhhhhhhh is the RBEP field of 
an IRb (bytes 12 through 15): 
entry-point address of 
asynchronously executed routine. 

• TQN hhhhhhhh indicates SVRB for 
transient routines. Is the RBSVTQN 
field (bytes 12 tnrough 15) : 
address of the next RB in the 
transient control queue. 

PSW hhhhhhhh hhhhhhhh 

is the RBOPSW field (bytes 16 tnrough 
23) : resume PSW. 

Q/TTR hhhhhhhh 

• In PRBs and SVRBs for resident 
routines, contains zeros in the 
first 2 digits. The last b digits 
contain the RBPGMQ field (bytes 2 5 
through 27) : queue field for 
serially reusable programs (also 
called the secondary queue) . 

• In IRBs, contains the RBUSE field in 
the first 2 digits (byte 24): count 
of requests for the same exit 
(ETXR) . The RBIQE field in last t> 
digits (bytes 25 tnrough 27) : 
starting address of the queue of 
interruption queue elements (IQE), 
or zeros in the first 4 diqits and 
the RBIQE field in the last 4 digits 
(bytes 26 and 27) : starting address 
of the request queue elements . 



In SVREs for transient routines the 
first 2 digits contain the RBTAWCSA 
field (byte 24) : number of requests 
(used if transient routine is 
overlaid) and the last 6 digits, the 
KESV1TR field (bytes 25 through 27): 
relative track address for the SVC 
routine. 



WT-LNK hhhhhhhn 

contains, in the first 2 digits, the 
REVvCF field (byte 28): wait count. 



contains, in the last b digits, the 
RELINK field (nytes 29 through 31) : 
starting address of the previous RB on 
the active RB queue (primary queuing 
field) or, if this is the first or 
only RB , the starting address of the 
TCE. 

RG 0-7 and RG 8-15 

is the RBGRSAVE field (bytes 32 
tnrough 95): in SVRBs and IREs, 
contents of registers through 15. 



EXTSA 



In IkBs, contains the RBNEXAV field 
in tne first 8 digits (bytes 96 
through 99) : address of next 
available interruption queue element 
(IQE), and in the remaining digits, 
the interruption queue element work 
space (up to 1948 bytes). 

In SVREs, contains the RBEXSAVE 
field (bytes 96 tnrough 143): 
extended save area for SVC routine. 



LOAD LIST 

NE hhhhhhhh 



RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list elements 
(LLEs) queued to the TCB by its TCBLLS 
field. The contents of 3 load list 
elements are presented per line until 
all elements in the queue are shown. 

NE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 0: zeros. 

contains, in the last 6 digits, LLE 
bytes 1 through 3: starting address 
of the next element in the load list. 



RSP-CDE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 4: the count of the number of 
requests made by LOAD macro 
instructions for the indicated load 
module. This count is decremented by 
DELETE macro instructions. 



contains, in the last 6 digits, LLE 
bytes 5 through 7: starting address 
of the CDE for the load module. 
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NCDE hhhhhh ROC-RB hhhhhhhh NM cccccccc 



EPA hhhhhh 



XL/MJ hhhhhh 



CDE 



identifies the next lines as the 
contents directory. One entry is 
presented per line. 



hhhhhhhh 

is the starting address of the entry 
given on the line. 

ATR1 hh 

is the attribute flags. 

NCDE hhhhhn 

is the starting address of the next 
entry in the contents directory . 

ROC-RB hhhhhhhh 

contains, in the first 2 digits, 
zeros. 

contains, in the last 6 digits, the 
starting address of the RB for the 
load module represented by this entry, 



NM cccccccc 

is the name of the entry point to the 
load module represented by this entry, 

USE hh 

is the count of the uses (through 
ATTACH, LINK, and XCTL macro 
instructions) of the load module, and 
cf the number of LOAD macro 
instructions executed for the module. 

EPA hhhhhh 

is the entry point address associated 
with the name in the Nft field. 

ATR2 hh 

is the attribute flags. 

XL/MJ hhhhhh 

is the starting address of the extent 
list (XL) for a major CDE, or the 
starting address of the major CDE for 
a minor CDE. (Minor CDEs are for 
aliases. ) 



hhhhhh SZ hhhhhhhh NO hhhhhhhh 



LN ADR LN ADR 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



XL 



indicates the next lines are entries 
in the extent list, which is queued to 
the major contents directory entry. 
Each extent list entry is given in one 
or more lines. Only the first line 
for an entry contains the left 3 
columns; additional lines for an entry 
contain information only in the right 
6 columns. 



hhhhhh 

is the starting address of the entry. 

SZ hhhhhhhh 

is the total length, in bytes, of the 
entry. 



NO hhhhhhhh 

is the number of scattered control 
sections in the load module described 
by this entry. If this number is 1, 
tne load module was loaded as one 
block. 

LN hhhhhhhh 

gives the length, in bytes, of the 
control sections in the load module 
described by this entry. Bit is set 
to 1 in the last, or only, LN field to 
signal the end of the list of lengths. 

ADR hhhhhhhh 

gives the starting addresses of the 
control sections. Each ADR field is 
paired with the LN field to its left. 
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DEB 
















hhhhhh 






hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhnh 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhh 


hhhhhhhh 


hhhhhhhh 












TIOT JOB 


cccccccc STEP 


cccccccc 


PROC cccccccc 










DD 


hhhhhhhh 


cccccccc 


hhhhhhhh hhhhhhhh 











DEB 



TIOT 



identifies the next lines as tne 
contents of the DEBs and their prefix 
sections. The first 6 digits in each 
line give the address of the DEB 
contents shown on the line, beginning 
with the second column. The first six 
digits of the first line contains the 
prefix section for the first DEB on 
the gueue. 

identifies the next lines as tne 
contents of the TIOT. 



STEP cccccccc 

is the name of the step whose tasx is 
being clumped. 



PRCC cccccccc 

is the name for the job step that 
called the cataloged procedure. This 
field appears if the job step whose 
task is being dumped was part of a 
cataloged procedure. 



DD 



JOB CCCCCCCC 

is the name of the job whose task ii 
being dumped. 



identifies the line as the contents of 
the DD entry in the TICT, 



MSS 




* * * # * 


******* SPQE *** 


********* 


*********** 


* * * * 


DQE *************** 


******* FQE ******** 






FLGS 


NSPQE 


SPID 


DQE 




BLK 


FQE 


LN NDQE 


NFQE LN 




hhhhhh 


hh 


hhhhhh 


ddd 


hhhhhh 




hhhhhh hhhhhh 


hhhhhh hhhhhh 


hhhhhhhh hhhhhhhh 


D-PQE 


hhhhhh 


FIRST 


hhhhhhhh 


LAST 


hhhhhhhh 












PQE 


hhhhhh 


FFB 


hhhhhhhh 


LFB 


hhhhhhhh 


NPQ 


hhhhhhhh 


PPQ 


hhhhhhhh 








TCB 


hhhhhhhh 


RSI 


hhhhhhhh 


RAD 


hhhhhhhh 


FLC 


hhhhhhhh 




FBQE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 








PQE 


hhhhhh 


FFB 


hhhhhhhh 


LFB 


hhhhhhhh 


NPQ 


hhhhhhhh 


PPQ 


hhhhhhhh 








TCB 


hhhhhhhh 


RSI 


hhhhhhhh 


RAD 


hhhhhhhh 


flc; 


hhhhhhhh 




FBQE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 









MSS 



identifies the next lines as the 
contents of the main storage 
supervisor gueue. This gueue includes 
subpool gueue elements (SPQE) , 
descriptor gueue elements (DQE), and 
free gueue elements (FQE) . 



hhhhhh 



is the starting address of the first 
€:lement shown on the line. 



SPQE 



identifies the 4 columns ceneath it as 

the contents of SPQEs . 



FLGS bh 

is the SPQE flag byte. 

NSPQE hhhhhh 

is the starting address of the next 
SPQE in the gueue. 
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SPID ddd 

is the subpool number. 

DQE hhhhhh 

for a subpool owned by the task being 
dumped: the starting address of the 
first DQE for the subpool. 

for a subpool that is shared: the 
starting address of the SPQE for the 
task that owns the subpool. 



DQE 



identifies the 4 columns beneath it as 
the contents of DQEs. 



BLK hhhhhn 

is the starting address of the 
allocated 2K block of main storage or 
set of 2K blocks . 

FQE hhhhhh 

is the starting address of the first 
FQE within the allocated blocks. 

LN hhhhhn 

is the length, in bytes, of the 
allocated blocks. 

NDQE hhhhhn 

is the starting address of the next 

DQE. 



FQE 



identifies the 2 columns beneath it as 
the contents of JQEs. 



NFQE hhhhhhhh 

is tne starting address of the next 

FQE. 

LN hhhhhhhh 

indicates the number of bytes in the 
free area. 



If no FEQEs exist, this field is the 
starting address of this PQE 

LFB hhhhhhhh 

is bytes 4 through 7 of the PQE: 
starting address of the last FBQE. If 
no FBQEs exist, this field is the 
starting address of this PQE. 

NPQ hhhhhhhh 

is bytes 8 through 11 of the element: 
starting address of the next PQE or, 
if this is the last PQE, zeros. 

PPQ hhhhhhhh 

is bytes 12 through 15 of the element: 
starting address of the preceding PQE 
or, if this is the first PQE, zeros. 

TCB hhhhhhhh 

is bytes 16 through 19 of the element: 
starting address of the TCB for trie 
jcb step to which the space belongs 
or, if the space was obtained from 
unassigned free space, zeros. 

RSI hhhhhhhh 

is bytes 20 through 23 of the element: 
size of the region described by this 
PQE (a multiple of 2048). 

RAD hhhhhhhh 

is bytes 24 through 27 of the element: 
starting address of the region 
described by this PQE. 

FLG hhhhhhhh 

is byte 28 of the element: 

bit when 0, indicates space 

described by this PQE is owned; 

when 1, indicates space is 
borrowed. 



D-PQE hhhhhh 

is the TCBPQE field (bytes 152 through 
155) : starting address minus 8 bytes 
of the dummy PQE shown on the line. 

FIRST hhhhhhhh 

is the starting address of the first 

PQE. 

LAST hhhhhhhh 

is the starting address of the last 

PQE. 

PQE hhhhhh 

is the starting address of the PQE 
shown on the line. 

FFB hhhhhhhh 

is bytes through 3 of the PQE: 
starting address of the first FBQE. 



bit 1 when 1 , indicates region has 

been rolled out (meaningful only 
when bit is 0) . 

bit 2 when 1, indicates region has 
neen borrowed. 

bit 3-7, reserved for future use. 



Note : PQE information is contained in two 
lines on the dump. When the rollcut/rollin 
feature or jy.ain Storage Hierarchy Support 
is included in the system, PQE information 
(with associated FBQEs) appears once in the 
durrp for each region segment of the jot) 
step. (Each FQE on the partition gueue 
defines a region segment. A job step's 
reqion contains more than one segment only 
when the step has rolled out another step 
or steps, or Main Storage Hierarchy Support 
is present.) 
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FBQE hhhhhh 



PFB hhhhhhhh 



is the starting address of the FBQE 
shown on the line. 



NFB hhhhhhhh 

is bytes through 3 of the element: 
starting address of the next FEQE. In 
the highest or only FBQE, this field 
contains the address of the PQE. 



is bytes 4 through 7 of the element: 
starting address of the previous FBQE, 
In the lowest or only FBQE, the field 
contains the address of the PQE. 



SZ hhhhhhhh 

is bytes 8 through 11 of the element 
size, in bytes, of the free area. 



QCB TRACE 










MAJ hhhhhh 


NMAJ hhhhhhhh 


PMAJ hhhhhhhh 


FMIN hhhhhhhh 


NM cccccccc 


MIN hhhhhh 


FQEL hhhhhhhh 


PMIN hhhhhhhh 


NMIN hhhhhhhh 


NM XX xxxxxxxx 




NQEL hhhhhhhh 


PQEL hhhhhhhh 


TCB hhhhhhhh 


SVRB hhhhhhhh 



QCB TRACE 

identifies the next lines as a trace 
of the queue control blocks (QCB) 
associated with the job step. Lines 
beginning with MAJ show major QCBs, 
lines beginning with MIN show minor 
QCBs, and lines beginning witn NQEL 
show queue elements (QEL) . 



MAJ hhhhhh 

is the starting address of the major 
QCB whose contents are given on the 
line. 



NMAJ hhhhhhhh 

is the starting address of the next 
major QCB for the job step. 

PMAJ hhhhhhhh 

is the starting address of the 
previous major QCB for the job step. 

FMIN hhhhhhhh 

is the starting address of the first 
minor QCB associated with the major 
QCB given on the line. 

NM cccccccc 

is the name of the serially reusable 
resource represented by the major QCB. 

MIN hhhhhh 

is the starting address of the minor 
QCB whose contents are given on the 
line. 

FQEL hhhhhhhh 

is the starting address of the first 
queue element (QEL) , which represents 
a request to gain access to a serially 
reusable resource or set of resources. 



PMIN hhhhhhhh 

is the starting address of the 
previous minor QCB. 

NMIN hhhhhhhh 

is the starting address of the next 
minor QCB. 

NM xx xxxxxxxx 

indicates, in the first 2 digits, the 
scope of the name or address of the 
minor QCB being dumped. If the scope 
is hexadecimal FF, the name is known 
to the entire operating system. If 
the scope is hexadecimal 00 or 10 
through FO, the name is known only to 
the job step; in this case, the scope 
is the protection key of the TCB 
enqueuing the minor QCB. 

Also contains, in the last 8 digits, 
the name or the starting address of 
the minor QCB. 

NQEL hhhhhhhh 

indicates, by hexadecimal 10 in the 
first 2 digits, that the queue element 
on the line represents a reguest for 
step-must-complete; by 00, ordinary 
request; and by 20, a 
set-must-complete request. 

Also contains, in the last 6 digits, 
the starting address of the next queue 
element in the gueue, or for the last 
queue element in the queue, zeros. 

PQEL hhhhhhhh 

indicates, by hexadecimal 8 in the 
first 2 digits, that the queue element 
represents a shared request or, by 
hexadecimal 00, that the element 
represents an exclusive request. (If 
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the shared DASD option was selected, 
hexadecimal 40 in the first 2 digits 
indicates an exclusive RESERVE request 
and 00 indicates a shared RESERVE 
request. ) 



TCB hhhhhhhh 

is the starting address of the TCB 
under which the ENQ macro instruction 
was issued. 



SVRB hhhhhhhh 

is the starting address of the SVRE 
under which the routine for the ENQ 
macro instruction is executed, or, 
after the requesting task receives 
control of the resource, the UCB 
address of a device being reserved 
through a RESERVE macro instruction 
(the latter value occurs only when the 
shared DASD option was selected) . 



SAVE AREA TRACE 














CCCCCCCC WAS ENTERED VIA LINK (CALL) ddddd 


AT EP ccccc . . 


• 








SA hhhhhh WD1 hhhhhhhh 


■HSA hhhhhhhh 


LSA hhhhhhhh 


RET hhhhhhhh 


EPA hhhhhhhh 


R0 


hhhhhhhh 


Rl hhhhhhhh 


R2 hhhhhhhh 


R3 hhhhhhhh 


R4 hhhhhhhh 


R5 hhhhhhhh 


R6 


hhhhhhhh 


R7 hhhhhhhh 


R8 hhhhhhhh 


R9 hhhhhhhh 


RIO hhhhhhhh 


Rll hhhhhhhh 


R12 


hhhhhhhh 


INCORRECT BACK CHAIN 














INTERRUPT AT hhhhhh 














PROCEEDING BACK VIA REG 13 















SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 
Each save area is presented in 3 or 4 
lines. The first line gives 
information about the linkage that 
last used the save area. This line 
will not appear when the RB .for the 
linkage cannot be found. The second 
line gives the contents of words 
through 5 of the save area. The third 
and fourth lines give the contents of 
words 6 through 18 of the save area; 
these words are the contents of 
registers through 12. Save areas 
are presented in the following order: 

1. The save area pointed to in the 
TCBFSA field of the TCB. This 
save area is the first one for the 
problem program; it was set up by 
the control program when the job 
step was initiated. 

2. If the third word of the first 
save area was filled by the 
problem program, then the second 
save area shown is that of the 
next lower level module of the 
task. However, if the third word 
of the first area points to a 
location whose second word does 
not point back to the first area, 
the message INCORRECT BACK CHAIN 
appears, followed by possible 
contents of the second save area. 



3. The third, fourth, etc. save 

areas are then shown, provided the 
third word in each higher save 
area was filled and the second 
word of each lower save area 
points back to the next higher 
save area. This process is 
continued until the end of the 
chain is reached (the third word 
in a save area contains zeros) or 
INCORRECT EACK CHAIN appears. 



Following the forward trace, the 
message INTERRUPT AT hhhhhh appears, 
followed by the message PROCEEDING 
BACK VIA REG 13. Then, the save area 
in the lowest level module is 
presented, followed by the save area 
in the next higher level. The lowest 
save area is assumed to be the 76 
bytes beginning with the byte 
addressed by register 13. These two 
save areas appear only if register 13 
points to a full word boundary and 
does not contain zeros. 

CCCCCCCC WAS ENTERED 

is the name of the module that stored 
register contents in the save area. 
This name is obtained from the RB. 

VIA LINK ddddd or VIA CALL ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 



ABEND/SNAP Dump (Systems with MVT) 61 



operand, if it was specified, of the 
LINK or CALL macro instruction. 



AT EP ccccc ., . . 

is the entry point identifier, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area . 

SA hhhhhh 

is the starting address of the save 
area. 

WD1 hhhhhhhh 

is the first word of the save area 
(optional) . 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In tne 
first save area in a job step, this 
word contains zeros. In all other 
save areas, this word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 
(register 13) : starting address of 
the save area in the next lower level 
(called) module. If the module 
containing this save area did not fill 
the word, it contains zeros. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14) : return address 
(optional) ; if the called module dia 
not fill the word, it contains zeros. 



EPA hhhhhhhh 

is the fifth word of the save area 



(register 15) : entry point to the 
called module. Use of this word is 
optional; if the called module did not 
fill the word, it contains zeros. 



RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12) : 
contents of registers through 12 for 
the module containing the save area 
immediately after the linkage. Use of 
these words is optional; if the called 
module did not fill tnese words, they 
contain zeros. 



INCORRECT EACK CHAII3 

indicates that the following lines may 
not be a save area because the second 
word in this area does not point back 
to the previous save area in the 
trace. 

INTERRUPT AT hhhhhh 

is the address cf the next instruction 
to be executed in the probleir program. 
It is obtained from the resume PSW 
word cf the last PRE or LPRB in the 
active RB queue. 

PROCEEDING EACK VIA REG 13 

indicates that the next 2 save areas 
are (1) the save area in the lowest 
level nodule, followed by (2) the save 
area in the next higher level module. 
The lowest save area is the save area 
pointed to by register 13. These 2 
save areas appear only if register 13 
points to a fullword boundary and does 
not contain zero. 



iiP^Hfe^ 
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CPUx PSA 
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NUCLEUS CONT. 
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hhhhhhhh 


hhhhhhhh 
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hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


REGS AT 


ENTRY TO ABEND (SNAP) 














FLTR 0-6 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 


REGS 0-7 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


REGS 8-15 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


LOAD MODULE cccccccc 
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LINE 


hhhhhh 


SAME AS ABOVE 














CSECT dd 


OF cccccccc 
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hhhhhhhh 
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*cccccccccccccccccccccccccccccccc* 



The contents of main storage are given 
under 6 headings: CPUx PSA, NUCLEUS, 
NUCLEUS CONT., LOAD MODULE CCCCCCCC, CSECT 
dd OF cccccccc, and in the trace table, SP 
ddd BLK hh. Under these headings, the 
lines have the following format: 

• First entry: the address of the 
initial bytes of the main storage 
presented on the line. 

• Next 8 entries: 8 full words (32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks) : 
the same 8 full words of main storage 
in EBCDIC. Only A through Z, through 
9, and blanks are printed; a period is 
printed for anything else. 

The following lines may also appear: 

LINES hhhhhh-hhhhhh SAME AS ABOVE 

are the starting addresses of the 
first and last lines for a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 



CPUx PSA (Model 65 Multiprocessing dumps 

only) 

identifies the next lines as the 
contents of the prefixed storage area 
(PSA) — through 4095 (FFF) . If the 
system is operating in partitioned 
mode (1 CPU), x is the CPU 
identification. If the system is 
operating in a 2 CPU multisystem mode, 
both PSAs are printed, the first under 
the heading CPUA PSA and the second 
under CPUB PSA. 

NUCLEUS 

identifies the next lines as the 
contents of the nucleus of the control 
program. 

NUCLEUS CONT. 

identifies the next lines as the 
contents of the part of the nucleus 
that lies above the trace table. 

REGS AT ENTRY TO ABEND or REGS AT ENTRY TO 

SNAP 

identifies the next 3 lines as the 
contents of the floating point and 
general registers when the abnormal 
termination routine received control 
in response to an ABEND macro 
instruction or when the SNAP routine 
received control in response to a SNAP 



ABEND/SNAP Dump (Systems with MVT) 63 



macro instruction. These are not the 
registers for the problem program when 
the error occurred. 



FLTR 0-6 

indicates the contents of floating 
point registers 0, 2, 4, and 6. 

REGS 0-7 

indicates the contents of general 
registers through 7. 

REGS 8-15 

indicates the contents of general 
registers 8 through lb. 



LOAD MODULE CCCCCCCC 

identifies the next lines as the 
contents of the main storage area 
occupied by the load module cccccccc, 
All the modules for the job step are 
dumped under this type of heading. 
Partial dumps do not contain this 
information. 

CSECT hhhh OF cccccccc 

identifies the next lines as the 
contents of the main storage area 
occupied by the control section 
(CSECT) indicated by hhhh. This 
control section belongs to the 
scatter-loaded load module cccccccc. 



TRACE TABLE 




























DSP NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R3 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


SW 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


I/O OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R3 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


SIO CC/DEV/CAW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


RES 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


SVC OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


PGM OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


EXT OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 



TRACE TABLE (SNAP dumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the name at the beginning of 
each line identifies the type of entry 
on the line: 



• DSP Dispatcher entry 

• I/O Input/output interruption entry 

• SIO Start input-output (SIO) entry 

• SVC Supervisor call (SVC) 

interruption entry 

• PGM Program interruption entry 

• EXT External interruption entry 

OLD PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code. 

contains, in the next 6 digits: 
device type. 



contains, in the last 8 digits: 
address of the channel address word 
(CAW) stored in the entry. 

R15/RO hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15 stored in the 
entry. 

contains, in the last 8 digits: 
contents of register stored in the 
entry. 

CSW hhhhhhhh hhhhhhhh 

is the channel status word (CSW) 
stored in the entry. 

Rl hhhhhhhh 

is the contents of register 1 stored 
in the entry. 

RES hhhhhhhh 

is reserved for future use; all digits 
are zeros. 

SW hhhhhhhh 

is reserved for future use; all digits 
are zeros. 

TCB hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 
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TRT 
X DSP 


NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


NUA 


hhhhhhhh 


NUB 


hhhhhhhh 


TME 


hhhhhh 


X I/O 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X SIO 


CC/DEV/CAW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


TCB 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X SVC 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X PGM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X EXT 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


MSK 


hhhhhhhh 


TQE 


hhhhhhhh 


TME 


hhhhhh 


X SSM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


AFF 


yyhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 



TRT (MVT with Model 65 multiprocessing 

clumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the letter and name at the 
beginning of each line identify the 
CPU and the type of entry, 
respectively : 



• DSP Dispatcher entry. 

• I/O Input/output interruption 

entry. 

• SIO Start input/output entry. 

• SVC Supervisor call interruption 

entry. 

• PGM Program interruption entry. 

• EXT External interruption entry. 

• SSM Set system mask entry. 

old PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code; in the next 6 digits: 
device type; in the last 8 digits: 
address of the channel address word 
stored in the entry. 

R15/R0 hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15; in the last I 
digits: contents of register 0, both 
as stored in the entry. 



CSW hhhhhhhh hhhhhhhh 

is the channel status word stored in 
the entry. 

Rl hhhhhhhh 

is the contents of register 1 as 
stored in the entry. 

TCti hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

NUA hhhhhhhh 

is the starting address of the new TCB 
for CPU A, as stored in the entry. 

OLA hhhhhhhh 

is the starting address of the old TCB 
for CPU A, as stored in the entry. 

MSK hhhhhhhh 

is the STMASK of the other CPU as 
stored in the entry. 

NUB hhhhhhhh 

is the starting address of the new TCB 
for CPU B, as stored in the entry. 

OLB hhhhhhhh 

is the starting address of the old TCB 
for CPU B, as stored in the entry. 

TQE hhhhhhhh 

is the first word of the timer queue 
element stored in the entry, provided 
a timer interrupt occurred. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 

AFF yyhhhhhh 

contains, in the first 2 digits: the 
ID of the locking CPU at the time of 
the interrupt; in the last 6 digits: 
starting address of the old TCB for 
CPU A, as stored in the entry. 
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SP ddd 








hhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


*cccccccccccccccccceccccccccccccc* 


END OF 


DUMP 







j SP ddd 

identifies the next lines as the 
contents of a block of main storage 
obtained throuqh a GETMAIN macro 
instruction, and indicates the subpool 

| number (ddd) . The part of subpool 252 
that is the supervisor work area is 
presented first, followed by the 
entire contents of any problem program 
subpools (0 through 127) in existence 
during the dumping. 

END OF DUMP 

indicates that the dump or snapshot is 
completed. If this line does not 
appear, the ABDUMP routine was 
abnormally terminated before the dump 
was completed, possibly because enough 
space was not allocated for the dump 
data set. 



Guide to Using an ABipND/SNAP D ump (MVT) 

Cause of Abnormal Termination : Evaluate 
tne user (USER=decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix B or the publication M essages an d 
Codes . 

Dumped Task : Check the ID field for an 
indication of which task is being dumped in 
relation to the task that was abnormally 
terminated: 

• 001 indicates a partial dump of a 
subtask 

• 002 indicates a partial dump of the 
invoking task 

If the ID field is absent, the dump 
contains a full dump of the task that was 
abnormally terminated. 

Active RB Queue : The first KB shown on the 
dump represents the oldest KB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last KB 
represents the ABDUMP routine and the 
second from last, the AEEND routine. The 
load module name and entry point (for a 
PRB) are given in a contents directory 
entry, the address of which is shown in the 
last 3 bytes of the FL/CEE field. 



Program Check PSW : The program check old 
PSW is the fifth entry in the first line of 
each RB printout. It is identified by the 
subheading APSW. For debugging purposes, 
the APSW of the third RB from the bottom of 
the dump is most useful. It provides the 
length of the last instruction executed in 
the program (bits 32,33), and the address 
of the next instruction to be executed 
(bytes 5-8). 

Lo ad List : Does the resume PSW indicate an 
instruction address outside the limits of 
the load module that had control at the 
time of abnormal termination? If so, lock 
at the LLEs on the load list. Each LLL 
contains the CDE address in the dump field 
labeled KSP-CDE. 

CD E s: The entries in the contents 
directory for the region are listed unoer 
the dump heading CDE. The printouts for 
each CDE include the load module and its 
entry point. If you have a complete dump, 
each load module represented in a CDE is 
printed in its entirety following the 
NUCLEUS section of the dump. 

Trace Table (SNAP dumps only) : Entries en 
an MVT SNAP dump, if valid, represent 
occurrences of SIO, external, SVC, program, 
I/O, and dispatcher interruptions. SIQ 
entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIC instruction. 
If the SIC operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. EXT and PGM 
entries are useful for locating the 
instruction where the interruption occurred 
(bytes 5-8 of the PSW) . 

SVC trace table entries provide the SVC old 
PSW and the contents of registers 0, 1, and 
15. The PSW offers you the hexadecimal SVC 
nuirber (bits 20-31), the CPU mode (bit 15), 
and the address of the SVC instruction 
(bytes 5-8) . The contents of registers 
and 1 are especially useful in that many 
system macro instructions pass key 
information in these registers. (See 
Appendix A.) 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
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address of the device that caused the 
interruption (bytes 2 and 3) , the CPU state 
at the time of interruption (bit 15), and 
the instruction address where the 
interruption occurred (bytes 5-8) . The CSW 
provides you with the unit status (byte 4), 
the channel status (byte 5) , and the 
address of the previous CCW plus 8 (bytes 
0-3). 

You can use the DSP entry to delimit the 
entries in the trace table. To find all 
entries for the terminated task, scan word 
7 of each trace table entry for the TCB 
address in a DSP entry. The lines between 
this and the next DSP entry represent 
interruptions that occurred in the task. 

Region Contents ; Free areas for the region 
occupied by the dumped task are identified 
under headings PQE and FBQE. The field 



labeled SZ gives the number of bytes in the 
free area represented by the FBQE. 

Subpool Contents ; Free and requested areas 
of the subpools used by the dumped task are 
described under the dump heading MSS. 
Subpool numbers are given under the SPID 
column in the list of SPQEs. If a GETMAIN 
macro instruction was issued without a 
subpool specification, space is assigned 
from subpool 0. Thus, two SPQEs may exist 
for subpool 0. The sizes of the requested 
areas and free areas are given under the LN 
column in the lists of DQEs and FQEs, 
respectively. 

Load Module Contents : The contents of each 
load module used by the job step are given 
under the heading XL. Each entry includes 
the sizes (LN) and startinq addresses (ADR) 
of the control sections in the load module. 
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Indicative Dump 



First digit: 



An indicative dump is issued when a task is 
abnormally terminated by an ABEND macro 
instruction, and a dump is requested, but a 
dump data set is not defined, due either to 
omission or incorrect specification of a 
SYSABEND or SYSUDUMP DD statement. In 
systems with PCP or MFT, an indicative dump 
is issued automatically on the system 
output (SYSOUT) device. Indicative dumps 
issued by these two systems are identical 
in format. Systems with MVT do not issue 
indicative dumps. 



Contents of an Indicative Dump 

This explanation of indicative dumps 
utilizes capital letters for the headings 
found in all dumps, and lowercase letters 
for information that varies with each dump, 
The lowercase letter used indicates the 
mode of the information, and the number of 
letters indicates its length: 



Bit Setting Meaning 
Instruction image not 
present 
Instruction image present 



Floating-point registers 
not present 

Floating-point registers 
present 

One general register set 

present 

Two general register sets 

present 

All active RBs present 
All active RBs not present 



Last digit: 

Digit in 
Hexadecimal Meaning 

All loaded RBs present 



• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a x-byte character 



Figure 25 shows the contents of an 
indicative dump. You may prefer to follow 
the explanation on your own indicative 
dump. 



8 All loaded RBs not present 

TCB FLAGS=hh 

is the first byte of TCBFLGS field 
(byte 2 9 in the TCB for the program 
being dumped): task end flag byte: 

Eit Setting Meaning 







Abnormal termination in 
process 

Normal termination in 
process 



CONTROL BYTE=hh 

describes the contents of the 
indicative dump. 



Abnormal termination was 
initiated by the resident 
ABTERM routine 




Figure 25. Contents of an Indicative Dump 
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3 1 ABTERM routine entered 

because of program 
interruption 

4 1 Reserved for future use 

5 1 Data set closing initiated 

by the AETERM routine 

6 1 The AETERM routine 

overlaid some or all of 
the problem program 

7 1 The system prohibited 

queuing of asynchronous 
exit routines for this 
task 

NO. ACTIVE RB=dd 

is the number of active RBs presented 
in the dump. 

NO. LOAD RB=dd 

is the number of RBs in the load list 
presented in the dump. 



COMPLETION CODE SYSTEM=hhh USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd) . Eoth 
SYSTEM=hhh and USER=dddd are printed; 
however, one of them is always zero. 



• Lost control to the input/output 
interruption handler, which 
subsequently terminated abnormally. 

• Was abnormally terminated ty the 
control program because of a program 
interruption. 

• Issued an ABEND macro instruction to 
request an abnormal termination. 

If REGISTER SET 2 also appears in the 
dump, the lines under REGISTER SET 1 
give the general register contents for 
a type II, III, or IV SVC routine 
operating under an SVRB. 

REGISTER SET 2 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB other than an SVRB when the 
program last passed control to a type 
II, III, or IV SVC routine. 

INSTRUCTION IMAGE=hhhhhhhhhhhhhhhhhhhhhhhh 
is 12 bytes of main storage, with the 
instruction that caused a program 
interruption in the right part of the 
printout. This field appears only if 
a program interruption occurred and is 
also valid when the instruction length 
in the resume PSW is 0. 



cccccc. . . 

explains the completion code or, if a 
program interruption occurred: 

PROGRAM INTERRUPTION ccccc.,. AT 

LOCATION hhhhhh 

where ccccc is the program 
interruption cause: OPERATION, 
PRIVILEGED OPERATION, EXECUTE, 
PROTECTION, ADDRESSING, 
SPECIFICATION, DATE, FIXED-POINT 
OVERFLOW, FIXED-POINT DIVIDE, 
DECIMAL OVERFLOW, DECIMAL DIVIDE, 
EXPONENT OVERFLOW, DECIMAL 
DIVIDE, EXPONENT OVERFLOW, 
EXPONENT UNDERFLOW, SIGNIFICANCE, 
or FLOATING-POINT DIVIDE; and 
hhhhhh is the address of the 
instruction being executed when 
the interruption occurred. 



REGISTER SET 1 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB when it: 

• Passed control to a type I SVC 
routine through an SVC instruction 
and the routine terminated 
abnormally. 



hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 
hhhhhhhhhhhhhhhn hhhhhhhhhhhhhhhh 

are the contents of floating-point 
registers 0, 2, 4, and 6 when the 
abnormal termination occurred. This 
field appears only if the floating 
point option is present. The first 2 
digits of each register are the 
characteristic of the floating point 
number. The last 14 digits are the 
mantissa. 



PROGRAM ID=cccccccc 

is the XRENto field (bytes through 
7): in PRE, LRBs, and LPREs, the 
program name; in IRBs, the first 
character contains flags for the timer 
or, if the timer is not being used, 
contains no meaningful information; in 
SVRBs for a type II SVC routine, 
contains no meaningful information; in 
SVRBs for a type III or IV SVC 
routine, the first 4 bytes contain the 
relative track address (TTR) of the 
load module in the SVC library and the 
last 4 bytes contain the SVC number in 
signed, unpacked decimal; in SIRBs, 
the name of the error routine 
currently occupying the 400-byte 
input/output supervisor transient 
area. 
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RB TYPE=hH 

indicates the type of active RB 

hh Type of KB 

00 PRB that does not contain entry 

points identified by IDENTIFY 

macro instructions 

10 PRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

20 LPRB that does not contain entry 
points identified by IDENTIFY 
macro instructions 

3 LPRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

40 IRB 

80 SIRB 

CO SVRB for a type II SVC routine 

DO SVRB for a type III or IV SVC 
routine 

E0 LPRB for an entry point identified 
£>y em IDENTIFY macro instruction 

F0 LRB 

ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15) : address of entry point in the 
program. 

RESUME PSW 

XRBPSW field (bytes 16 throuch 23): 
is the contents of the resume PSW". 



PM=h 



is bits 36 through 39 of PSW: 
mask. 



program 



SM=hh 



K=h 



is bits through 7 of PSW: system 
mask. 

is bits 8 through 11 of PSW: 
protection key. 



AMWP=h 

is bits 12 through 15 of PSW: 
indicators. 

IC=hhhh 

is bits 16 through 31 of PSW: 
interruption code. 

IL.CC=h 

is bits 32 through 3 5 of PSW: 
instruction length code (bits 32 and 
33) and condition code (bits 34 and 
35) . 



IA=hhhhhh 

is bits 40 through b3 of PSW: 
instruction address. 

PROGRAM ID=CCCCCCCC 

is the XRBNM field (bytes through 
7) : program name. 

RB TYPE=hh 

indicates the type of RB: 

h n Type of RE 

20 LPRB that does not contain entry 

points identified £y IDENTIFY 

macro instructions. 
3 LPRE that contains one or more 

entry points identified by 

IDENTIFY macro instructions. 
E0 LPRB for an entry point identified 

by an IDENTIFY macro instruction. 
F0 LRB. 

ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15) : address of entry point in tne 

program. 

Gu ide to Using an Indicative Dump 

Co mpletion Code : Evaluate the user 
(USER=decimal code) or system (SYSTEM=hex 
code) completion code using either Appendix 
B of this publication or the publication 
Messages and Codes . The line under the 
completion code gives a capsule explanation 
of the code or the type of program 
interruption that occurred. 

In struction Address : If a program 
interruption occurred, get the address cf 
the erroneous instruction in the last 3 
bytes of the field labeled INSTRUCTION 
IMAGE. 

Ac tive RB Queue : RBs are shown in the 
first group of two-lxne printouts labeled 
PROGRAM ID and RESUME PSW, with the most 
recent RB shown first. There are two lines 
for as many RBs indicated by NC. ACTIVE 
RE=dd. 

Register Contents : General register 
contents at the time a program last had 
control are given under the heading 
REGISTER SET 2 or, if this neading is not 
present, under REGISTER SET 1. Register 
contents, particularly those of register 
14, may aid you in locating the last 
instruction executed in your program. 
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Core Image Dump 



MVT: 



A core image dump displays all of main 
storage from location 00 through the end of 
printable storage. These dumps are 
identical for all control program options, 
except for the first line of the dump, 
which identifies the control program 
option; i.e., PCP, MFT, MVT, or M65MP. 

The Damage Assessment routine (DAK) will 
produce a core image dump when a system 
task fails if the SYS1.DUMP data set is 
properly defined and available to accept 
the dump. Once the core image dump has 
been written to the SYS1.DUMP data set, the 
print dump program (IEAPRINT) can print it. 

I Note : IEAPRIJT is placed in 
SYS1.LINKLIB at SYSGEN time; it may be 
invoked with the JCL statements shown in 
Figure 23. 



DAMAGE ASSESSMENT ROUTINE (DAR) 

The Damage Assessment routine (DAR) is 
designed to provide increased system 
availability in the event of a system 
failure, and to provide more meaningful 
diagnostic information by means of a core 
image dump taken at the time of the system 
failure. This core image dump is written 
to the SYS1.DUMP data set, which you may 
print by means of the IEAPRINT print dump 
program. 

If a system routine fails, DAR attempts 
to reinitialize the failing task, thereby 
permitting the system to continue operation 
without interruption. DAR permits the 
system to continue processing in a degraded 
condition if it encounters a system failure 
that does not permit total reinstatement of 
the affected task or region. The operator 
will be informed, via a WTO, that the 
system is in an unpredictable state; he 
then must decide whether or not 
already-scheduled jobs should be allowed to 
attempt completion. 



SYSTEM FAILURE 



System Error Task 
Kollout/Rollin Task 
Communications Task 
Master Scheduler Task 
Transient Area Fetch Task 

A system failure is also caused by an 
ABEND recursion in other than OPEN, CLOSE, 
ABDUMP, or 3TAE; by a failure of a task in 
'must complete' status; or, in MFT only, by 
a failure in the scheduler if no SYSAEEND 
or SYSUDUMP DD card is provided. 



I THE SYS1.DUMP DATA SET 

One of the primary functions of the Damage 
Assessment routine is to provide a core 
image dump at the time of a system failure. 
Secondary storage space must be available 
to receive this dump. The SYS1.DUMP data 
set provides this space. 

The SYS1.DUME data set may reside on 
tape or on a direct access device. 

Tape 

If you wish to have the SYS1.DUMP data set 
reside on tape, you may specify the tape 
drive during IPL. If the drive has not 
been made ready prior to IPL, a MOUNT 
message is issued to the console, 
specifying the selected device. The device 
should be mounted with an unlabeled tape. 

Keep in mind that the Damage Assessment 
routine rewinds and unloads a tape after 
writing a core image dump. If the operator 
has not readied the specified device before 
a second core image dump is to be written, 
DAR will bypass the writing of the dump but 
will continue processing. 

Direct Access 

If you wish to have the SYS1.DUMP data set 
placed on a direct access device, you may 
preallocate the data set at SYSGEN or prior 
to any IPL of the system. The following 
restrictions apply: 

• The data set name must be SYS1.DUMP. 



If . a system failure occurs, the Damage 
Assessment routine immediately attempts to 
write a core image dump to the SYS1.DUMP 
data set. A system failure may be caused 
by a failure in any of the following system 
tasks : 

PCP and MFT: 

Communications Task 
Master Scheduler Task 
Log Task (MFT only) 



• The data set must be cataloged on the 
IPL volume. 

• The data set may be preallocated on any 
volume that will be online during 
system operation. 

• The data set must be seguential. 

• Sufficient space must be allocated to 
receive a core image dump for all of 
main storage. 
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When a direct access device is used for 
the SYS1.DUMP data set, the data set can 
hold only one core image dump. If 
additional failures occur, and if the 
SYS1.DUMP data set is occupied, DAR does 
not attempt to write another core image 
dump. 

You may execute the print dump program 
(IEAPRINT) to produce hard copy of the 
dump. Once the print dump program is 
executed, the SYS1.DUMP data set can accept 
another core image dump. 



THE PRINT DUMP PROGRAM (IEAPRINT) 

You must use the print dump program to 
print out the core image dump contained on 
the SYS1.DUMP data set. The print dump 
program is placed in SYSl.LINKLIB at SYSGEN 
time; it may be invoked in the same manner 
as any other problem program. 

You must supply the job control 
statements for the print dump program; the 
following statements are reguired: 



JOB 



EXEC 



SYSPRINT DD 



SYSUT1 DD 



This is a standard statement. 



This statement specifies the 
program name (PGM=IEAPRINT) 
or, if the job control 
statements reside on the 
procedure library, the 
procedure name. 



This statement defines an 
output data set. The data set 
may be written onto a system 
output device, a magnetic tape 
volume, or a direct access 
device. 



This statement defines the 
input data set. The DSNAME 
SYS1.DUMP must be used. 



(See Figure 26 for the JCL statements 
reguired to execute the IEAPRINT print dump 
program. ) 
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Figure 26. Sample JCL Statements Required for IEAPRINT 
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Input to the Print Dump Program 

Input to the IEAPRINT program is the 
sequential data set SYS1.DUMP, which may 
reside on either a direct access device or 
on magnetic tape. The first byte of the 
first record on the SYS1.DUMP data set will 
be the contents of storage location 00, and 
the data set will contain the full core 
image up to the last writable byte- The 
input devices supported are: 

IBM 2301 Drum Storage Unit 

IBM 2302 Disk Storage Drive 

IBM 2303 Drum Storage Unit 

IBM 2311 Disk Storage Drive 

IBM 2314 Storage Facility 

IBM 2400 Magnetic Tape Drive 

Output From the Print Dump Program 

The output from the print dump program is a 
formatted core image dump of the printable 
contents of main storage, beginning at 
location 00. The dump may be written onto 
a system output device, a magnetic tape 
volume, or a direct access device. You 
must define the device, upon which the dump 
is to be written, on the SYSPRINT DD card 
of the JCL statements that invoke the print 
dump program. (See Figure 26.) 



CONTENTS OF A CORE IMAGE DUMP 

The core image dump is formatted into two 
distinct sections: low storage and 
register contents are displayed on the 
first paqe, and a printout of the contents 
of main storage begins on the second page. 
The main storage contents are unedited and 
are displayed beginning from location 00 
through the end of printable storage. (See 
Figure 27.) 



The remainder of the first page consists 
of a printout of register contents and 
hardware control words as they appeared at 
the time of the failure. The contents of 
floating point registers 0, 2, 4, and 6 are 
displayed; if the floating point feature is 
not present in the system, these register 
printouts contain zeros. The two lines 
beginning with REG 0-7 and REG 8-15 show 
the contents of general registers through 
7 and 8 through 15, respectively. 



Storage below location 128(80 hex) is 
permanently assigned and can be used to 
determine the status of a program. The 
line beginning 40-CSW (following the 
register printout) gives, in unedited form, 
the CSW and CAW. The next five lines 
contain the new and old PSWs for the five 
types of interruptions. 



The last line in 
dump, beginning 4C- 
contents of locatio 
(57 hex), which inc 
the timer. This li 
useful in locating 
information, such a 
table. The use of 
explained under the 
to Using...". 



Main Storage 



this portion of the 
UNUSED-, gives the 
ns 76 (4C hex) through 87 
lude unused bytes and 
ne contains pointers 
key debugging 
s the CVT and the trace 
these locations will be 

sections headed "Guide 



The main section of the dump is printed 
starting with location zero and continuing 
to the end of printable storage. Each line 
contains, from left to right: 

• The hexadecimal storage address of the 
first byte on the line. 

• Eight words of storage in hexadecimal. 

• The same eight words in EBCDIC, 
enclosed in asterisks (*). 



Low Storage and Registers 

The initial section of a core image dump 
(the first page) consists of information of 
immediate use to the programmer who must 
determine the cause of the failure. 



If one or more consecutive lines contain 
the same word throughout the line, the 
first line will be printed, followed by the 
message, 

hhhhhh TO THE NEXT LINE ADDRESS - SAME AS 
ABOVE 



The first printed line displays the 
control program option of the operating 
system, i.e. PCP, MFT, MVT, or M65MP; the 
timer contents at the time of the failure; 
and the date of the failure. 



where: 

hhhhhh 

is the address of the first omitted 
line. 
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CORE IMAGE DUMP OF MVT SYSTEM 
FLOATING POINT REGISTERS 



TIMER* 0840B2 



C9D5C9E3C9i;iE3D6 09407DC 1D3D3 7D40 



E6C1C9E3C9D5C740 



0000000000000000 



REG 0-7 
REG 8-1.5 



C0020CD0 SCCOOCOe 00021B98 OOOOOOFO 
00021B8C 0OFFFFF8 00000068 400586EE 



00000010 400586EC 00020C00 00021748 
6007EAB2 000587Ap 00008904 OOOOOOOB 



40-CSh O0OCO5COOC0O0OO0 



48-CAW 00004408 



EXTERNAL INTERRUPT PSWS 
SUPERVISOR CALL FSWS 
PROGRAM CHECK PSWS 
MACHINE CHECK PSkS 
INPUT/OUTPUT PSWS 



NEW=000 4 00000000762 e 
NEW=0004 000COOOC8080 
NEW=000400000000 78 5C 
NEW=O0CO 0000000 184C0 
NEW=OCC4C0CC0O0O77E0 



CLO=0 1040080 80038BF6 
OLD=FF040C015000D8C4 
OLC^OCOCCCCCCCOOOCOO 
OLD=OOOCFFOOO0000000 
OLD-FF06C29I8COC0000 



4C-UNUSED-0000OE48 



50-TIMER-C840B262 



54-UNUSED-0000EE70 



OOCOOO OCCCOCCC OCCCOOOO 00000000 OCOOOOOC 00OODE4R 

0CC02C FF0400C1 5000C8C4 COOOOOOC OCOOOOOO OOOOFFOO 

00C04C 0CCCD5CC CCCCCCCO 0CC044Ce OCC00E48 084CB262 

000060 0C0400CC OOOOROBC 0CC40C00 0000785C cooooooo 

000080 A7ABCCFF F2F39FFF OF003FFF F23F9FFF 00000000 

OOOOAO 0000400C 4C0CO0C0 30C08CCB 005FNF81 001AC200 

OCOCCC 00000429 0CC006CC CC000429 0383:1600 02078300 

OOOOEQ FF6FFFFF CCOOOOOO C02CF9FF OOO3B30A 00000000 

0CC10C OCCCOCCC 001001CA CCCCOCCC CC80E800 CCOCOOOO 

00C12C OCCCOCCC OCOOOOOO 00000000 02010000 00000000 

0CC14C CCCCCCCC COOOOOCC CCCCCCCC OCOOOOOO OOOCOOOO 

00016C OOOOCCOO OCCOOOCC OCCOOOOO 8200017C OOOCCCOO 

0CC18C OCCCOCCC OCOOOOCO CCOOOOOO 00000000 00000000 

CCC1AC TC THE NEXT LINE ADDRESS - SAME AS ABOVE 

0C0200 FF060291 8000C0CC 0CC00OO1 0001D344 CCCCDE48 

0CC220 00C2CCC0 8C00D68C 90C0D832 0C021508 0001C310 

000240 8C000644 000C24F4 CCCCOCOO OCOOOOOO COOCOCOO 

0CC260 OCCOOOOC COOOOOOO COOOOOOC OCOOOOOO OOOCOOOO 

0CC28C OCCCOCCC COOOCOOO CCOOOOOO 00000000 OOOOA820 

0CC2AC OOCC010C 82G0C3O0 34CC350C 36CC0001 CC07F8CC 

OC02CO 00CC8340 00008340 00000000 OOOOCOIF 112C1BE4 

0CC2EC OOOOOOOC C001S4C0 CCC20C00 0C00CA21 CCC4C0CC 

000300 00000000 00000000 OOOOOOOC 00000000 OOOOCOOO 

0CC32C 1C THE NEXT LIKE ACDRESS - SAWE AS ABOVE 

000340 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 

0C0360 TC THE NEXT LINE ACDRESS - SAME AS ABOVE 

0CC4CC ccccoccc cccooccc cccoocoo ococoooo oooooooo 

000420 TC THE NEXT LINE ACCRESS - SAME AS ABOVE 

0CC460 CCCCOCOO OCCOCOCC OOOOOOOO OOOOOOOO 0C0090EF 

0CC480 05109110 E2BC471C 050C912I E2BC4770 06209120 

CCC4A0 04714770 04BE58EC E2BC54E0 C508477C C4BE91CF 

0CC4C0 0408FC0C 98EF04DO 820004D8 OOOOOOOO OCOOOOOO 

0CC4EC OOOOOOOO OCCCOCCC CCCCOOOO OCOOOOOC OC020CCO 

00C50C 00020F10 0000D5F2 CEFFFFFF 94EFE2BC 968002CC 

0CC52C 478CC56C 56FCC2SC 9300F001 47800542 C500F0OO 

00C54O 04BE020C F000E2B8 C207EC0C 02E058E0 06140700 

OC0560 94F702CC 58F00618 58E0061C 07000700 46E0057C 

0C0580 9121E2GC 477CC62C 46FC0568 4U005F0 47F004BE 

0005A0 91FFF0OC 478004BE C207040B O018D207 CC58C5EC 

0C05C0 D600C4DB 001BD207 001804D8 940F001B D2O70O56 

0CC5EC C1C4CCCC CCCC05B8 CCC40CCC 0COOO5BC 0C02CC00 

000600 0004000C 300006A4 00019948 OOOOOOOO 0C8C0000 

CCC62C SCEFC4E0 58E0O2BO 9120E2BC 4710C888 91010471 

000640 E2BC471C 074091C1 04714780 06540207 00400400 

0CC660 47F00588 91C302AF 077E91A1 02BC078E 9CEF04E8 

000680 912102BC 47ECC6C4 58F0060C 58E002B0 91FFE032 

OCCfcAC 82C00600 S4CFC471 C6CCC470 001B4780 C6B69602 

O0C6C0 47FCC58C 98EF04E8 07FE9048 O4F05OE0 05045860 

0CC6EC C718968C 0ZBC4EEC C66491C2 64714780 06E84180 

OOC700 62C04570 07185840 02C04570 07189848 04FC58E0 

0CC720 1255077E '585C4CC0 91FF501C 077807F7 D70302C0 

00C74C 900F0810 910302AF 47eC075C 5eE002B0 94FEE2BC 

000760 488C7000 417070C2 548C087C 47800760 558C0870 

OCC78C lCCCee2C 0CC4542C CE74442C 087C4780 07604320 

0C07A0 07AA58C0 086845F0 D0064320 02B8542C 08748920 



COOOOOOO C1040C8C 80038BF6 
OOOOOOCO FF060291 80000000 
0000EE70 00040000 00007628 
000I84CC CCC40000 0O0077E0 
COOOOOOC FFFFFFFF 0CC880CC 
FFC40000 020L0000 OOOOOOOO 
C3DAE8C1 C070CF8A D207C030 
OOOOOOOO OOOOOOOO 00021000 
46C082B9 CCCCCOOO 5010CF03 
OOOOOCCO OOOOOOOO OOOOOOCO 
COOOOOOO OOOOOOOO OOOOOOOO 
00038280 COOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO OOOOOOOO 

00O0OE48 00C1D380 4000D5CA 
F30024F8 OC020CDO 000006CA 
OOOOOOOO OOOOOOOO OOOOOOOO 
OCOCCCCC COOOCCCC OOOOOOOO 
OCOOOOOO 0000DE38 00019CC8 
CCCCCCCC C200COCO OOOOOOOO 
24F8020A 02DA02DA 02DA7FFF 
00007628 OC040000 00000472 
OOOOOOOO OOOOOOOO OOOOOOOO 

FFFFFFFF FFFFFFFF FFFFFFFF 

OOOOOOOO OOOOCOCC OOOOOOCO 



C40C5EEC 
04714710 
001B477C 
OOOOOOOO 
400005CA 
918CE2CC 
02B84770 
07000700 
910802CC 
58F00608 
82000058 
C2F841F0 
00000A22 
0003512F 
4780C63E 
9BEF04E0 
58FC061C 
47100686 
C4714tF0 
02B04170 
07305840 
05O407FE 
02C0D703 
980F0810 
4780074C 
10005420 
00045720 



C2B09120 001B4710 
04BA41F0 02F09107 
C4BE41FC 00180207 
OCOOOOOO OOOOOOOO 
00020CC0 70000622 
477CC53A 9120001B 
C54241F0 02E847FC 
46EC0558 848005F0 
47700594 5eEC02B0 
9102F001 478005A8 
82C005E8 947F02CC 
02F84 7F0 04BE0000 
0104COCO 000006AO 
CCC01F40 000006CB 
0207C4C0 C04091C1 
918002CC 47800492 
5CFCC60C 841005FC 
96200471 820005F8 
0678D207 04C004E8 
06F25840 62C445eO 
02C44570 071858-40 
12440788 48504020 
62C062C0 47F007CE 
47F00646 58700864 
5810086C 1A184320 
08785920 02B44770 
08704420 088447F0 
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Figure 27. Sample of a Core Imaqe Dump 
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Stand-Alone Dump 



Stand-alone hexadecimal dumps display all 
of main storage with the exception of 
certain low storage locations. These dumps 
are the only means by which you can see the 
untouched contents of main storage at a 
given time. They are identical in format 
for all levels of the operating system. 

In this discussion, dumps are referred 
to as PCP f MFT, and MVT dumps, depending on 
which level operating system occupied the 
CPU at the time the dump was taken. 



Invoking a Stand-Alone Dump 

A stand-alone dump is most useful when a 
program check or unexpected wait has 
occurred and abnormal termination and 
ABEND/SNAP routines overlaid a critical 
area of main storage. To recover this 
critical area, re-execute the job step and 
take a stand-alone dump at the point where 
abnormal termination or the wait occurred. 

To reach this point, either (1) turn on 
the wait bit in the program check PSW or 
(2) set an address stop at the entry point 
to the ABTERM routine. To find the entry 
point of ABTERM, stop the system after IPL 
but before setting the date, and display 
the address of the CVT given at location 
16(10). Then, display the contents of the 
word beginning at CVT+52(34). This word 
contains the address of the entry point to 
ABTERM. Next, run the job with an address 
stop set at this address. when the system 
enters the wait or manual state, IPL and 
execute the dump program you have produced 
from the IMD3ADMP macro instruction, or 
execute card program number UT-056 to 
produce a stand-alone dump. The 
stand-alone dump described here is the one 
produced by the card program UT-056. For a 
discussion of the dump produced by the 
service aids IMDSADMP and IMDPRDMP, and for 
discussions of the other IBM provided 
service aids, see the manual, IBM 
System/360 Operating System: Service Aids , 
GC28-6719. 



Contents of a Stand-Alone Dump 

A stand-alone dump comprises three 
different types of storage printouts, each 
with its own format: 



» The initial areas 

• Lower main storage and registers 

• Remaining main storage 

To return the largest practical number 
of main storage locations, editing of the 
initial area of the dump is limited. 
However, locations to 23(17) and 128(80) 
to 319 (13F) are destroyed. If you wisn to 
see the contents of these areas, you must 
display them before taking the dump. 
Figure 28 illustrates the three printout 
formats in a stand-alone dump. 

Initial areas : The initial areas (the 
first page) printed in a stand-alone dump 
consist of locations 320(140) through 1023 
OFF) . The first 16 lines are locations 
320(140) through 383 (17F), printed at a 
rate of one word per line. The second 8 
lines are locations 384(180) through 511 
(IFF) , printed 4 words per line. The last 
16 lines represent locations 512(200) 
through 1023 OFF), 8 words per line. The 
printout of the initial areas is followed 
by a legend of the hexadecimal address 
limits of each area. 

Low Storage and Registers : The next 
section of the dump (top of page 2) is a 
printout of register contents and hardware 
control words. If the floating point 
feature is present, the first line gives 
the contents of floating point registers 0, 
2, 4, and 6. The two lines, beginning with 
REG0 and REG8, show the contents of general 
registers through 7 and 8 through 15, 
respectively. 

Storage below location 128(80) is 
permanently assigned and can be used to 
determine the status of a program. The 
line beginning 40-CSW (following the 
register printout) gives, in edited form, 
the CSW and CAW. The next ten lines are a 
table containing the old and new PSWs for 
the five types of interruptions. The 
identification and address of each PSW is 
given on tne first two lines across the top 
of the table. Entries in the table (i.e., 
edited fields in each PSW) make up the 
remaining 8 lines. 

The last line in this portion of the 
dump, beginning 4C-UNU3ED-, gives the 
contents of locations 76 (4C) through 
87(57), which include unused bytes and the 
timer. On some dumps, this line contains 
pointers useful in locating key debugging 
information, such as the CVT and the trace 
table. 
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Remaining Main Storage ; The contents of 
remaining main storage, beginning at 
location 1024(400), are printed in the 
third and largest portion of the dump. 
Each line contains, from left to right: 

• The hexadecimal storage address of the 
first byte on the line. 

• Eight words of storage in hexadecimal. 

• The same eight words in EBCDIC, 
enclosed in asterisks (*) . (This field 



is found only in dumps issued with 
release 9 and after.) 



If one or more lines contain the same 
word throughout the line, the lines are 
omitted from the dump and the message 
hh hhhh TO THE NEXT LINE ADDRESS CONTAINS 
hhhhhhhh is substituted, where hhhhhh is 
the address of the first omitted line and 
hhhhhhhh is the common word. 
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Figure 28. Sample of a Stand-Alone Dump 
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Guide to Using a Core Image or a 
Stand-Alone Dump 



The core image dump and the stand-alone 
dump are both hexadecimal dumps of the 
contents of main storage. The stand-alone 
dump destroys the contents of locations 
to 23 (18) and 128 (80) to 319 (13F) , but 
aside from this, the hexadecimal printouts 
of the stand-alone and the core image dump 
are identical. The debugging procedures to 
be used for either of these dumps are the 
same, and are presented, in the following 
pages, under the sxib-headings: Guide to 
Using a PCP Dump, Guide to Usin g an MFT 
Dump , and Guide to Using an MVT Dump . 

If you are not sure under which system 
configuration the stand-alone dump was 
taken, pick up the address of the CVT from 
the formatted section of the dump, 
following the heading 4C UNUSED. Add 74 
hex to this address and look at that 
location in the dump. The first two 
hexadecimal digits found at this location 
are the contents of the CVTDCE field, and 
indicate the system configuration according 
to the following convention: 

10 MVT Uniprocessing 

14 MVT Multiprocessing 

20 MFT 

40 PCF 
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Guide to Using a PCP Dump 

Cause of the Dump : Evaluate the PSWs that 
appear in the formatted section of the dump 
(first or second page), to find the cause 
of the dump. 

The PSW has the following format: 



TRACE lABIE : Look at the 3-word trace 
table control hlock. 



1 Current- entry 


t First entry 


t Lest entry 



D rogram 


Status 


Word 










System Mask 


Key 


AMWP 


Interruption Code 


7 8 11 12 15 16 


31 


1LC 


CC 


Program 
Mask 


Instruction Address 



32 33 34 35 36 39 40 



63 



• Does the instruction address field of 
the old machine check PSW show either 
the value E2 or E02? If so, a hardware 
error has occurred. 

• Does the instruction address field of 
the old program check PSW have a value 
other than zero. If so, a program 
check at the instruction preceding that 
address caused the interruption. 

Active RB Queue : To find the active RB 
queue, look at location 384(180 hex), the 
TCB. The first word of the TCB contains a 
one-word pointer to the first word of the 
most recent RB added to the queue. In its 
eighth word, RB+28(lC), each RB contains a 
pointer to the next most recent RB. The 
last RB points back to the TCB. The TCB 
occupies locations 384(180) to 504 (1F8). 
You can determine the identity of the load 
module by looking either in the first 
and/or second words of the RB for its 
EBCDIC name or in the last 3 digits of the 
resume PSW in the previous RB for its SVC 
number. The entry point to the module is 
in the last 3 bytes of the fourth word in 
the RB, RB+13(D) . 

Load List : In systems with PCP, the load 
list is a chain of request blocks 
associated with load modules invoked by a 
LOAD macro instruction. By looking at the 
load list, you can determine which system 
and problem program routines were loaded 
before the dump was taken. 

To construct the load list, look at the 
tenth word in the TCB, location 4 20(1A4), 
for a pointer to the most recent RB entry 
on the load list (RB-8). This word, in 
turn, points to the next most recent entry 
(minus 8), and so on. The word preceding 
the most recent RB on the list (RB-4) 
points back to the TCB's load list pointer. 



Location 20(14) contains the address of the 
first word of this control block. If you 
are using a stand-alone dump and do not 
have access to the contents of location 
20(14), scan the contents of main storage 
between locations 16,384(4000) and 
32,768(8000) for trace table entries. Each 
entry is four words long. To find the 
table boundaries and the current entry, 
scan the table in reverse until you reach 
the three-word trace table control block. 

To distinguish trace table entries, look 
at the fourth and fifth digits of the first 
words for the following bit configurations: 

r — ■ t t T 

I I Fourth Digit | Fifth Digit | 
| | 8 4 2 1 bits | 8 4 2 1 bits | 

Y— — + + -i 

| SIO | i i 

I SVC I 1 i 1 i 
I I/O I 1 i i 

L_. X X J 

Trace table entries for systems with PCP 
are 4 words long and represent occurrences 
of SIO, I/O, and SVC interruptions. Figure 
29 gives some sample entries and their 
contents. 

SIO entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
address of the device on which the 
interruption occurred (bytes 2 and 3), the 
CPU state at the time of interruption (bit 
15), and the instruction address where the 
interruption occurred (bytes 5-8) . The CSW 
provides you witn the unit status (byte 4), 
the channel status (byte 5) , and the 
address of the previous CCW plus 8 (£>ytes 
0-3). 

SVC entries provide the SVC old PSW and the 
contents of registers and 1. The PSW 
offers you the hexadecimal SVC number (bits 
20-31), the CPU mode (bit 15), and the 
address of the SVC instruction (bytes 5-8) . 
The contents of registers and 1 are 
useful in that many system macro 
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instructions use these registers for 
parameter information. Contents of 
reqisters and 1 for each SVC interruption 
are given in Appendix A. 



sro 



,00000,190, l OOOOorgSj 



,00000000 



04GG0OG0 



Condition Device 
code address 



CAW 



CSW 



I/O 



.FF060190 



0000320A 



0001F708 OCOO0OO0, 



I/O old PSW 



SVC number 



CSW 



SVC 



,FF051009 SOOWSA, tOOOSFSBCj ,00000050 



SVC old PSW 



Register Register 1 



Figure 29. Sample Trace Table Entries 

(PCP) 

CVT: To find the CVT, a source of other 
pointers, look at location 76 (4C) in the 
formatted section of the dump (first or 
second page) . The address given following 
the heading 4C-UNUSED- points to the first 
word of the CVT. 

Que u e o f DEBS ; To find the queue of DEBs, 
look at location 392(188). The address 
given there points to the first word of the 
most recent entry on the DEB queue. The 
last three bytes of the second word in each 
DEB (DEB+S) point to the next most recent 
DEB on tne queue. The queue contains one 
DEB for each open data set. 

UCB s: Unit information for each device can 
jbe found in the UCB. The address of the 
UCB is contained in the last 3 bytes of the 
ninth word of the DEB, DEB+33(21). If the 
DEB queue is empty, scan the dump around 
location 4096(1000) for words whose fifth 
and sixth digits are FF. These are the 
first words of the UCBs for the system; 
UCBs are arranged in numerical order by 
device address. (You may find it easier to 
locate UCBs by looking for the device 
address in the EBCDIC printout to the right 
of each page.) The first two bytes of the 
second word of each UCB give the device 
address. The device type and class are 
given in the third and fourth bytes of the 
fifth word, UCB+18(12). The sense bytes 



begin in the last two bytes of the sixth 
UCE word, UCB+22(lb), and extend for from 1 
to 6 bytes depending on the device type. 
Sense bytes are explained in Appendix F. 

DC B : The address of the DCB, a control 
block that describes the attributes of an 
open data set, is in the last 3 bytes of 
the seventh DEB word, DEB+25(19). 

IOB: The IOB for an open data set contains 
a pointer to the CCW list in the last three 
bytes of the fifth word, IOB+17(ll). The 
IOB address is in the seventeenth word of 
the DCB, DCB+68(44). You can also locate 
the IOB associated with an I/O request by 
looking at the fourth word of the trace 
table entry for an SVC 0. 

ECB: The address of the ECB is in the last 
3 bytes of the second word of the IOB 
(IOB+5). The completion code for the I/O 
event is posted in the first byte of the 
ECB. ECB completion codes are explained in 
Appendix E. If the I/O event is not 
complete and an SVC 1 has been issued, the 
hiqh-crder bit of the ECB is on, and bytes 
1 through 3 contain the address of the 
associated RB. 

Free Areas : Areas of main storage 
available for allocation at the time the 
dump was taken are described by the MSS 
boundary box and a series of FQEs . The 
seventh word of the TCB, TCE+24(18), points 
to the MSS boundary box. The first word of 
the MSS boundary box points to the FQE with 
the higbest processor storage address, and 
the fourth word, to the FQ> with the 
hiqhest 2361 core Storage address. The 
first word of each FQE points to the next 
lower FQE; the second word gives the length 
of the free area it describes. FQEs occupy 
the first 8 bytes of the area they 
describe. 

Guide to Using an MET Dump 

Cause of the Dump : Evaluate the PSWs that 
appear in the formatted section of the dump 
(first second page) , to find the cause of 
the dump. 

The PSfc has the following format: 



•Vogram 


Status 


Word 










System Mask 


Key 


AMWP 


Interruption Code 


7 8 11 12 15 16 


31 


ILC 


cc 


Program 
Mask 


Instruction Address 



32 33 34 35 36 



39 40 



63 
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• Does the instruction address field of 
the old machine check PSW show either 
the value E2 or E02? If so, a hardware 
error has occurred. 

• Does the instruction address field of 
the old program check PSW have a value 
other than zero? If so, a program 
check at the instruction preceding that 
address caused the interruption. 

Finding the TCB : To find the TCB for the 
task that had control at the time the dump 
was taken : 



1. 



2. 



3. 



Look at location 76 (4C) , following the 
heading 4C -UNUSED-, for a pointer to 
the CVT. 

The first word of the CVT contains a 
pointer to a doubleword of TCB 
addresses, which contain pointers to 
the next TCB to be dispatched (first 
word) and the current TCB (second 
word) . 

The TCB found at the address shown in 
the second word represents the task 
that last had control. 




Task 
control 



Most recent 
task invoked 
by the same 
parent task 



Most recent task 
invoked by the 
task in control 



• Figure 30. Re-Creating the Task Structure 

Re-Creating the Task Structure (MFT with 
Subtasking only) ; To re-create the task 
structure for the job step, use the 
thirty-third through thirty-fifth words of 
the TCB. The thirty- fourth word. 



TCB+132(84), contains the address of the 
TCB for the parent task. The thirty-third 
word, TCB+128(80), is a pointer to the TCB 
of the task invoked most recently by the 
same parent task. The thirty-fifth word, 
TCE+136(88), contains the address of the 
TCE for the subtask invoked most recently 
by the task in control, or zeros if none 
were invoked. Each TCB in the job step 
contains the same pointers. Using these 
TCB pointers, you can re-create a task 
structure to aid in locating the point of 
error, as shown in Figure 30. 

Finding the Partiiton TCBS 

The partition TCBs (job step TCBs in MFT 
with subtasking) can be found by beginning 
at the CVTIXAVL field of the CVT, offset 
124 (7C). The address contained at CVTIXAVL 
is a pointer to the IOS freelist. At 
offset 4 in the IOS freelist is a pointer 
to tne first address in a lsit of TCB 
addresses. You can look through this list 
of TCB addresses, and, keeping your system 
options in mind, find the TCBs for each 
partition (the job step TCBs in an MFT with 
subtasking system) . The TCB addresses are 
listed in the following order: 

« Transient area loading task. 

• System error task (MFT witn 
subtasking) . 

• Multiple console support write- to-log 
task (optional) . 

• I/O recovery management support task 
(optional) . 

• Communications task. 

• Master scheduler task. 

• System management facilities task 
(optional) . 

• Partition task. 

• Partition 1 task. 



• Partition n task. 

In an MFT system with subtasking, the 

partition TCBs (job step TCBs) may be found 

by a more direct method. CVT offset 

245 (F5) contains a pointer to the partition 

job step TCB address in this address 

table. 

To recreate the task structure within 
any partition, simply locate the job step 
TCB, and follow the TCB pointers - as 
explained in the previous section, 
"Re-Creating tbe Task Structure." 

Active JRB Queue i The first word of a TCB 
points to the most recent RB added to the 
active RB gueue. Each RB on the active RB 
queue, contains a pointer to tne previous 
RB in its eighth word, RB+28(1C). The last 
RB points back to the TCB. You can 
determine the identity of the load module 
by looking either in the first and/or 
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second words of the RE for the EBCDIC name, 
or in the last 3 digits of the resume PSW 
in the previous KB for the SVC number. The 
entry point to the module is given in the 
last 3 bytes of the fourth word in the Rri, 
RB+13(D) . 



Trace Table ; Look at the 3-word trace 
table control block, which precedes the 
table by several words (usually four 
words) : 



Load Lis t: In systems with IVjFT , the load 
list is a chain of request blocks 
associated with load modules invoked by a 
LOAD macro instruction. By looking at the 
load list, and at the job pack area queue 
described below, you can determine which 
system and problem program routines were 
loaded before the dump was taken. To 
construct the load list associated with the 
task in control, look at the tenth word in 
the TCB, TCB+36(24), for a pointer to the 
most recent RB entry on the load list, 
minus 8 bytes (RB-3) . This word, in turn, 
points to the next most recent entry (minus 
8), and so on. The word preceding the most 
recent RB on the list (RB-4) points back to 
the TCB's load list pointer. 

Job Pack Area Queue (MiFT w ith suntasking 
only) : To reconstruct the job pack area 
queue, look at TCB-H25 (7D) for a three byte 
pointer to the Partition Information Block 
(PIB). The twelfth word of the PIB, 
PIB+44(2C), points to the most recent RB on 
the job pack area queue minus 8 bytes 
(RB-8). This word in turn points to the 
next most recent RB minus 8, and so on. 
The word preceding the most recent RB on 
the queue (RB-4) points back to the job 
pack area queue pointer in the PIB. You 
can determine the identify of the load 
module by looking either in the first 
and/or second words of the RB for its 
EBCDIC name, or in the last three digits of 
the resume PSW in the previous RB for the 
SVC number. The entry point of the module 
is given in tne last three bytes of the 
fourth word in the RB, RB+29(1D), unless it 
is an FRB. 

The first five words of an FRB 
(beginning at offse'.t minus 8) are identical 
in content to those of otner RBs. The 
XRWTL field, offset 12(C), contains the 
address of a wait list element. The first 
word of the WLE points to the next WLE, or 
contains zeros if the WLE is the last one. 
The second word points to the waiting SVRB. 
You can determine the number of deferred 
requests for the module by tracing the 
chain of WLEs. 

The XRREQ field of an FRB, offset 
16(10), contains a pointer to the TCB of 
the requesting task. The next word, 
XRTLPRB, offset 20(14), points to an LPRB 
built by the Finch routine for the 
requested program. The FRB for the 
requested program is removed from the job 
pack area queue by the Finch routine when 
the program is fully loaded. 



t Current- entry 


+ First entry 


t Last entry 



Location 20(14) contains the address of the 
first word of this control block. If you 
are using a stand-alone dump and do not 
have access to the contents of location 
20(14), scan the contents of main storage 
between locations 16,384(4000) and 
32,768(8000) for trace table entries. 
Entries are four words long and begin at 
addresses ending with zero. To find the 
table boundaries and current entry, scan 
the table in reverse until you reach the 
trace table control block. Figure 31 gives 
some sample trace table entries and their 
contents . 



SIO 



ppooopoc, 


,1003FC68, 


,00014600 


OCOOOOOO, 




1 








1 











I/O 



Condition C 
code c 


)evice CAW 
ddress 


CSW 




,FF070T 


93 100 1442 A, 


,00014600 


OCOOOOOO, 



















I/O old PSW 



CSW 



SVC 



SVC number SVC 

I 


address 








.FF051001 






0001, 


,000145BC, 


2001442A 1 , ,0000 

























SVC old PSW 

Task switch identifier 
(after release II ) 



jister Register I 



Task 
Switch 



FF05F090 T001442A, .00003ED8, .00003F26, 



Dispatched new PSW New TCB Old TCB 

address address 

Figure 31. sample Trace Table Entries 

(MET) 
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SIO entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
address of the device on which the 
interruption occurred (bytes 2 and 3) f the 
CPU state at the time of interruption (bit 
15) , and the instruction address where the 
interruption occurred (bytes 5-8) . The CSW 
provides you with the unit status (byte 4) , 
the channel status (byte 5), and the 
address of the previous CCW plus 8 (bytes 
0-3). 

SVC entries provide the SVC old PSW and the 
contents of registers and 1. The PSW 
offers you the hexadecimal SVC number (bits 
20-31), the CPU mode (cit 15), and the 
address of the SVC instruction (bytes 5-8) . 
The contents of registers and 1 are 
useful in that many system macro 
instructions use these registers for 
parameter information. Contents of 
registers and 1 for each SVC interruption 
are given in Appendix A. 

TASK SWITCH entries look similar to an SVC 
entry, except that words 3 and 4 of the 
entry contain the address of the TCBs for 
the "new" and "old" tasks being performed, 
respectively. The trace table entries for 
one particular task are contained between 
sets of two task switch entries. Word 3 of 
the beginning task switch entry and word 4 
of the ending task switch entry point to 
the TCB for that task. Task switch entries 
are identified by a fifth digit of ' F'. 



Queue of DEBs ; To find the gueue of BEBs 
for the task, look at the third word in the 
TCB (TCB+8). It points to the first word 
of the most recent entry on the DEB gueue. 
The last three bytes of the second word in 
each DEB (DEB+5) point to the next most 
recent DEB on the gueue. The gueue 
contains one DEE for each open data set. 



UCBs ; Unit information for each device can 
be found in a UCB. The address of the UCB 
is contained in the last 3 bytes of the 
ninth word of the DEB, DEB+33(21). If the 
DEB gueue is empty, scan the dump around 
location 4096(1000) for words whose fifth 
and sixth digits are FF. These are the 
first words of the UCBs for the system; 
UCBs are arranged in numerical order by 
device address. (You may find it easier to 
locate UCBs Jay looking for the device 
address in the EBCDIC printout to the right 
of each page.) The first two bytes of the 



second word of each UCB gives the device 
address. The sense bytes begin in the 
second byte of the sixth UCB word, UCB+22 
(16), and extend from 1 to 6 bytes, 
depending on the device type. Sense bytes 
are explained in Appendix F. The device 
type and class are given in the third and 
fourth bytes of the fifth word, 
respectively . 

DCB ; The address of the DCB, a control 
block that describes the attributes of an 
open data set, is located in the last 3 
bytes of the seventh DEB word, DEB+25(19). 

IOB : The IOB for an open data set contains 
a pointer to the CCW list in the last three 
bytes of the fifth word, ICB+17 (11) . The 
IOB address is located in the seventeenth 
word of the DCB, DCB+68(44). ^ou can also 
locate an IOB by looking at the fourth word 
of a trace table entry for an SVC 0. 



ECB : The address of the ECB for BSAM and 
BDAM data sets can be found in the last 3 
bytes of the second word of the IOB 
(IOB+5). The completion code for the I/O 
event is posted in the first byte of the 
ECB. ECB completion codes are explained in 
Appendix E. If the I/O event is not 
complete and an SVC 1 has been issued, the 
high-order bit of the ECB is on, and bytes 
1 through 3 contain the address of the 
associated RB. 



Free Areas ; Areas of a partition that are 
available for allocation at the time the 
dump was taken are described by the MSS 
boundary box and a series of FQEs. The 
seventh word of the TCB for the task, 
TCB+24(18), points to a six-word MSS 
boundary box. The first word of the MSS 
boundary box points to the FQE with the 
highest processor storage address in trie 
partition, and the fourth word, to the 
highest 2361 Core Storage address in the 
partition. The seccnd word of the FQE 
gives the length of the area it describes. 
FQEs occupy the first 8 bytes of the area 
they describe. 

Gotten Subtask Areas ; Areas of a partition 
allocated by the system to a subtask within 
the partition are described by gotten 
subtask area gueue elements (GQE) . The 
seventh word of the subtask TCB, 
TCB+24(18), points to a one word pointer to 
the most recently created GQE on the GQE 
gueue. Bytes through 3 of the GQE 
contain a pointer to the previous GQE or, 
if zero, indicate that the GQE is the last 
one on the gueue. Bytes 4 through 7 of the 
GQi, contain the length of the gotten 
suctask area. Each GQE occupies the first 
eight bytes of the gotten subtask area it 
describes. 
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Guide to Using an MVT Dump 



Cause of the Dump :: Evaluate the PSWs that 
appear in the formatted section of the dump 
(first or second page) , to find the cause 
of the dump., 



The PSW has the following format: 



sio 



SIO entry identifier 



$0000,123, ,00000£58i ,000047F8 OC000O00, 



Condition Device CAW 

code address 



CSW 



OOOO4B00 00000000 .Q00Q366Q. ,61!99D E , 



TCB address Timer 



Program Status Word 



System Mask 


Key 


AMWP 


1 iterruption Code 





7 8 11 12 15 16 


31 


ILC 


CC 


Program 
Mask 


Instruction Address 



32 33 34 35 36 



39 40 



63 



• Does the instruction address field of 
the old machine check PSW show either 
the value E2 or E02? If so, a hardware 
error hcis occurred. 

• Does the instruction address field of 
the old program check PSW have a value 
other than zero? If so, a program 
check at the instruction preceding that 
address caused the interruption. 



Trace Table : Location 84(54), labeled 
54-UNUSED-hhhhhhhh en the dump, contains 
the address of the first word of a 3-word 
trace table control block that immediately 
precedes the table: 



^Current entry 


t First entry 


t Last entry 



Entries in an MVT trace table are 8 
words long and represent occurrences of 
SIO, external, SVC, program, I/O, and 
dispatcher interruptions. You can identify 
what type of interruption caused an entry 
by looking at the fifth digit: 

= SIO 

1 -= External 

2 = SVC 

3 = Program 
5 == I/O 

D : = Dispatcher 



Figure 32 gives some sample entries and 
their contents . 



I/O entry 
identifier 

Device address 



Vo 



I , Dev 

FQ65m 



FF 065 193 80000000, |0Q0Q46B8 0C000000, 



I/O old PSW 



CSW 



00004BOO 00000000 00003660 ^>U98E9E, 



Timer 



Entry identifier 
(SVC here) SVC number 



SVC 
External 
Program 
Dispatcher 



: 042005 



FF042003 400Q6ACE, ,0.Q0Q46C0, ,000000] 7, 



SVC old PSW 



Register 15 Register 



00000039, 00000000 ,O00l2C E8i ,08 1 ED 160, 



Register 



TCB address 



Timer 



Figure 32. Sample Trace Table Entries 
(MVT) 

In dumps of Model 65 Multiprocessing 
systems, trace table entries differ as 
follows: 



SIC 



I/O 



SVC and 
Program 



5th word: address of TCB. 
6th word: address of old TCB 

for CPU A. 
7th word: address of old TCB 

for CPU B. 
8th word: CPU identification 

(last byte) . 

3rd word: contents of register 

15. 
4th word: contents of register 

0. 
8th word: CPU identification 

(last byte) . 

6th word: address of old TCE 

for CPU A. 
7th word: address of old TCB 

for CPU B. 
8th word: CPU identification 

(last byte) . 
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Dispatcher 6th word: 



7th word: 



External 



8th word: 



6th word: 
7th word: 

8th word: 



address of new TCB 
for CPU A. 
address of new TCB 
for CPU B. 
CPU identification 
(last byte) . 

STMASK of other CPU, 
TQE if timer inter- 
rupt occurred . 
CPU identification 
(last byte) . 



Finding the TCB : To find the TCB for the 
task that had control at the time the dump 
was taken, perform one of the following 
steps: 



1. Examine the current entry in the trace 
table. Look at the seventh word of 
this entry for the address of the TCB. 
If an I/O interruption caused the 
current entry, scan the table in 
reverse order for the corresponding 
SIO entry (the most recent SIO entry 
having the same device address) . The 
seventh word of this entry contains 
the TCB address. 



Parent 
task 




Task I 
contro 



Most recent 
task invoked 
by the same 
parent task 



Most recent task 
invoked by the 
task in control 



2. If you do not have a trace table, look 
at location 76 (4C) for a pointer to 
the CVT, following the heading 
4C-UNUSED-. The first word of the CVT 
contains a pointer to a doubleword of 
TCB addresses, which contains pointers 
to the next TCB to be dispatched 
(first word) and the current TCB 
(second word). Beginning with the 
current TCB, you can recreate the task 
structure for the job step. 

Note : If the first word of the TCB located 
by the above steps points to itself, there 
are no ready tasks to be dispatcned, and 
the system has been placed in an enabled 
wait state. This TCB, now in control, is 
called the System Wait TCB. 

Recreating The Task Structure : To recreate 
the task structure for the job step, use 
the thirty-third through thirty-fifth words 
of the TCB. The thirty-fourth word, 
TCB+132(84), contains the address of the 
TCB for the parent task. The thirty-third 
word, TCB+128(80), is a pointer to the TCB 
of the task invoked most recently by the 
same parent task. The thirty-fifth word, 
TCB+136(88), contains the address of the 
TCB for the subtask invoked most recently 
by the task in control, or zeros if none 
were invoked. Each TCB in the job step 
contains the same pointers. Using these 
TCB pointers, you can recreate a task 
structure to aid in locating the point of 
error, as shown in Figure 33. 



Figure 33. Recreating the Task Structure 



Active RB Queue : The first word of the TCB 
points to the most recent RB added to the 
queue. Each RB contains a pointer to the 
next most recent RB in its eighth word, 
RB+28(1C). The last RB points back to the 
TCB. Unlike the RBs for other systems, the 
name and entry point of the associated load 
module are not always contained in the RB 
associated with the module. Instead, they 
are found in a contents directory entry. 



CPE : The address of the contents directory 
entry for a particular load module is given 
in the fourth word of the RB, RB+12(C). 
The CDE gives the address of the next entry 
in the directory (bytes 1-3) , the name of 
the lead module, bytes 8-15(F); the entry 
point of the module, bytes 17-19(11-13); 
and a pointer to the extent list, bytes 
21-23(15-17). 



Load List : To construct the load list 
associated with the task in control, look 
at the tenth word in the TCB, TCB+36(24), 
for a pointer to the most recent load list 
entry (LLE) . Each LLE contains the address 
of the next most recent entry (bytes 0-3) , 
the count (byte 4) , and the address of the 
CDE for the associated load module (bytes 
5-7) . 
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)ueue of BEB:e 



To find the queue of LEBs 



for the task, look at the third word in the 
TCB (TCB+8). The address given here points 
to the first word of the most recent entry 
on the DEB queue. Tne last three hytes of 
the second word in each DEB (DEB+5) points 
to the next most recent DEB on the queue. 
The queue contains one DEB for each open 
data set. 



OCBs : Unit 
be found in 
is contained 
ninth word o 
DEB queue is 
location 409 
and sixth di 
first words 
UCBs are arr 
device addre 
locate UCBs 
address in t 
of each page 
second word 
address. Th 
given in the 
fifth word, 
sense bytes 
of the sixth 
extend for f 
the device t 
in Appendix 



information for each device can 
a UCB. The address of the UCB 

in the last 3 bytes of the 
f the DEB, DEB+33(31). If the 

empty, scan the dump around 
6(1000) for words whose fifth 
gits are FF. These are the 
of the UCBs for tne system; 
anged in numerical order by 
ss. (You may find it easier to 
by looking for the device 
he EBCDIC printout to the ri^ht 
. ) The first two bytes of the 
of each UCB give the device 
e device type and class are 

third and fourth bytes of the 
UCB+18(12), respectively. Tne 
are given in the last two bytes 

UCB word, UCE+22(16), and 
rom 1 to b bytes, depending on 
ype. Sense Dytes are explained 
F. 



DCB : The address of the DCB, a control 
block that describes the attribiites of an 
open data set, is located in the last 3 
bytes of the seventh DEB word, DEE+2b(19). 

IOB : The IOB for an open data set contains 
a pointer to the CCW list in tne last three 
bytes of the fifth word, IOB+17(ll). The 
IOB address is located in the seventeenth 
word of the DCB, DCB+o8(44). ¥ou can also 
locate the IOB for an I/O request ty 



looking at the fxfth word of the trace 
table entry for the SVC 0. 



ECE : ine address of the ECB for E3AM and 
BDhA data sets can be found in the last 3 
bytes of the second word of the ICE (IOE+5) 
or in the last 3 bytes of the 
thirty-seventh word of the TCB, 
TCE+145(91). The completion code for tne 
I/O event is posted in the first byte of 
the ECE. ECB completion codes are 
explained in Appendix B. If the I/O event 
is not complete and an SVC 1 has been 
issued, the hiqh-order tiit of the ECB is 
on, and bytes 1 through 3 contain the 
address of the associated BE". 

Reg ion Content s: The TCB for the dumped 
task contains a pointer to the dummy 
partition queue element minus 8 in its 
thirty-ninth word, TCB+152(98). Tne first 
word cf the dumm> t-Qh points to the first 
PQtL and the second word, to the last PQE. 
Eacn FCE, in turn, points to tne first and 
last FBgEs within a given storaqe 
nierarcny . 

Su- opool Contents : The seventh word of the 
TCB, TCB+24(18), points to the SICE 
representing the first subpool used by the 
task. Each SFC.±, contains the address of 
the next SBQE (r.ytes 1-3), the subpool 
number (£yte 4) , and the address cf the 
first DQE for the subpool (bytes 5-7) or, 
if the subpool is cwned by another task 
(bit is 1), the address of the SICE that 
describes it (.cytes 5-7) . Each LQE 
contains a pointer to tne F^E representing 
the free area with the highest main storage 
address in the subpool (bytes 1-3), a 
pointer to the next LQE (bytes 5-7) , and 
the length of tne area described by the 
DQ1, bytes 13-15 (D-F) . 
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Appendix A: SVCs 



Register contents at entry to an SVC routine are often helpful in finding pointers and 
control information. The table below lists SVC numbers in decimal and hexadecimal, and 
gives the type, associated macro instruction, and significant contents of registers and 
1 at entry to each SVC routine. 

Macro instructions followed by an asterisk (*) are documented in the System 
Programmers Guide . Expanded descriptions of remaining macro instructions listed here may 
be found in the publication Supervisor and Data Management Macro Instructions . Graphics 
and telecommunications macro instructions are discussed in the Program Logic Manuals 
associated with these access methods. 



Decimal 
No. 



T T 

Hex. 
No. 



Type 



Macro 



Register 



Register 1 





1 
1 

1 
2 
3 
4 
5 
6 
7 
8 

9 
10 

10 
11 
12 
13 
14 
15 



I 
I 

I 
I 

I 

I 

II 

I 

I 

II 

II 

II 

I, II 

I 

I 

I, III 
II 
IV 

II, III 
I 



EXCP * 
XDAP * 
WAIT 
WAITR 

PRTOV 
POST 

GETMAIN 

FREEMAIN 

LINK 

XCTL 

LOAD 

DELETE 

GETMAIN or 
FREEMAIN 
(R Operand) 

FREEPOOL 

TIME 
SYNCH * 
ABEND 
SPIE 



Event count 
Event count 



Completion code 



Address of entry point 
address 

Address of program name 

Subpool number (byte 0) 
Length (bytes 1-3) 



IOB address 



ECB address 

2 ' s complement of 
ECB address 



ECB address 

Parameter list address 
Parameter list address 
Parameter list address 
Parameter list address 
DCB address 



Address of area to 
be freed 



Time units code 

Completion code 

PICA address 

Address of reguest gueue 
element 



(Part 1 of 4) 
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r T T T T 



Decimal 
No. 


Hex. 

NO. 


Type 


Macro j Register 


| Register 1 

_L _ _ _ 


1 
16 


r ~ 1 
10 


r 1 
III 


r — t 
PURGE * | 


T 


17 


11 


III 


RESTORE * | 


1 10B chain address 


18 


12 


II 


BLDL | Address of nuild list 


|DCB address 


18 


12 


II 


FIND | 




19 


13 


IV 


OPEN | 


| Address of parameter list 
jof DCB addresses 


20 


14 


IV 


CLOSE | 


| Address of parameter list 
jof DCB addresses 


21 


15 


III 


STOW (Parameter list address 


|DCB address 


22 


16 


IV 


OPEN TYPE=J*| 


| Address of parameter list 
jof DCB addresses 


23 


17 


IV 


CLOSE TYPE=T | 


| Address of parameter list 
jof DCB addresses 


24 


18 


III 


DEVTYPE * | 


jddname address 


25 


19 


III 




|DCB address 


26 


1A 


IV 


CATALOG * | 


j Parameter list address 


26 


1A 


IV 


INDEX * | 


j Parameter list address 


26 


1A 


III 


LOCATE * | 


| Parameter list address 


27 


IB 


III 


OBTAIN * | 


j Parameter list address 


28 


1C 


IV 






29 


ID 


IV 


SCRATCH * |UCB address 


j Parameter list address 


30 


IE 


IV 


RENAME * |UCB address 


j Parameter list address 


31 


IF 


IV 


FEOV | 


JDCB address 


32 


20 


IV 




j Address of UCB list 


33 


21 


III 


IOHALT | 


JUCE address 


34 


22 


IV 


MGCR (MAST | 
CMD EXCP) | 




35 


23 


IV 


WTO | 


J Message address 


35 


23 


IV 


WTOR | 


j Message address 


36 


24 


IV 


WTL | 


| Address of message 


37 


25 


II 


SEGLD | 


j Segment name address 


37 


25 


II 


SEGWT | 


| Segment name address 


38 


2 6 


II 






39 


27 


III r IV 


LABEL | 


j Parameter list address 



L X X X X X J 
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| Decimal 
| No. 

h 

j 40 


Hex. 
No. 
1- 

28 


Type 

1- 1 

I, II, 
III 


Macro 

h ^ 

EXTRACT 


Register 
. 




| Register 1 
+ 

| Parameter list address 


1 4i 


29 


II, III 


IDENTIFY 


Entry point name 


addr 


ess | Entry point address 


| 42 


2A 


II, III 


ATTACH 








| 43 


2B 


II, III 


CIRB * 


Entry point address 


jsize of work area in 
| doulDlewords 


| 44 
| 45 


2C 
2D 


I 
II 


CHAP 


i+ Increase priority 
Decrease priority 


|TCB address 


| 46 


2E 


I 


TTIMER 






|1: Cancel 


| 47 


2F 


II 


STIMER 


Exit address 




| Timer interval address 


| 48 


30 


I, II 


DEQ 






|CjCB address 


| 49 


31 


III 


TEST 








| 50 


32 


IV 










1 51 


33 


IV 


SNAP 






| Parameter list address 


1 52 


34 


IV 








|DCB address 


| 53 


35 


III 


RELEX 


Key address 




|DCB address 


| 54 


36 


II 










| 55 


37 


IV 


EOV * 


EOB address 




|DCB address 


| 56 


38 


I, II 


ENQ 


QEL address 




| QCB address 


1 56 


38 


I, II 


RESERVE * 








1 57 


39 


III 


FREEDBUF 


DECB address 




|DCB address 


| 58 


3A 


I 


RELBUF 






|DCB address 


| 58 


3A 


I 


REQBUF 






|DCB address 


| 59 


3B 


III 










| 60 
1 61 


3C 
3D 


III 
III 


STAE 


Create SCB 
4 Cancel SCB 
8 




j Parameter list address 
| Parameter list address 


1 62 


3E 


II 


DETACH 






|TCB address 


| 63 


3F 


IV 


CHKPT 






|DCB address 


| 64 


40 


III 


RDJFCB * 






| Address of parameter list 
|of DCB addresses 


| 65 


41 


II 








j Parameter list address 


| 66 


42 


IV 
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r n 
| Decimal 
| No. 


Hex. 
No. 


Type 


Macro 


Register 


| Register 1 
4- 


r i 
1 67 


r i 
43 


r i 
II 


ENDREADY 




| QPCST 




| 68 


44 


IV 


SYNADAF 


Same as register on 
entry to SYNAD 


|Same as register 1 on 
| entry to SYNAD 


| 68 


44 


IV 


SYNADRLS 








| 69 


45 


III 


BSP 




\DCt, address 




| 70 


46 


II 


GSERV 




(Parameter list 


address 


1 71 


47 


III 


RL SEBFR 




| Parameter list 


address 


1 71 


47 


III 


ASGNBFR 




j Parameter list 


address 


1 71 


47 


III 


EUFINQ 




| Parameter list 


address 


| 72 


48 


IV 






(Parameter list 


address 


| 73 


49 


III 


SPAR 




| Parameter list 


address 


1 74 


4A 


III 


DAR 




(Parameter list 


address 


1 75 


4B 


III 






| Parameter list 


address 


| 76 


4C 


III 










| 77 


4D 


IV 










| 78 


4E 


III 










| 79 


4F 


I 


STATUS 








| 80 


50 


III 










| 81 


51 


IV 


SETPRT 








| 82 


52 


IV 










| 83 


53 


III 


SMFWTM * 




| Message address 




| 84 


54 


I 




UCB address and cuffer 
restart address 






| 85 


55 


IV 










| 86 


5 6 


IV 


ATLAS 




(Parameter list 


address 


| 87 


57 


III 


DOM 


If zero 

If negative 


|A DOM message 1 
|A pointer to a 
(message I.Ds 


.D. 

list Of DOM 


| 88 


58 


III 


MOD 8 8 


Routine code 


|DCB address 




| 89 


59 


III 


JiMSRV 




(Parameter list 


address 


| 90 


5A 


IV 


XQMNGR 


Address of list of 
ECB/IOB pointers 
(optional) 


(QMPA address 




| 91 


5B 


III 


VOLSTAT 


DCB address 


jzero: issued by CLOSE 
| Non-zero: issued by EOV 



L L -L- 



± 



-L J 

(Part 4 of 4) 



90 Programmer's Guide to Debugging (Release 19) 



Appendix B: Completion Codes 



Completion codes issued by operating system 
routines are often caused by problem 
program errors. This appendix includes the 
most common system completion codes, their 
probable causes, and how to correct the 
error or locate related information using a 
dump. For a more comprehensive coverage of 
completion codes, see the publication 
Messages and Codes. 



OCx A program check occurred without a 
recovery routine. If bit 15 of the 
old program PSW (PSW at entry to 
ABEND) is on, the problem program had 
control when the interruption 
occurred; "x" reflects the type of 
error that . causes the interruption: 

x Cause 

1 Operation 

2 Privileged operation 

3 Execute 

4 Protection 

5 Addressing 

6 Specification 

7 Data 

8 Fixed-point overflow 

9 Fixed-point divide 
A Decimal overflow 

B Decimal divide 

C Exponent overflow 

D Exponent underflow 

E Significance 

F Floating-point 

The correct register contents are 
reflected under the heading "REGS AT 
ENTRY TO ABEND" in an ABEND/SNAP dump. 
In a stand-alone dump, register 
contents can be found in the register 
save area for ABEND'S SVRB. 

0F1 A program check occurred in the 

interruption handling part of the 
input/ output supervisor. The 
applicable program check PSW can be 
found at location 40(28). (In systems 
with MFT, this PSW is valid only if 
the first four digits are 0004). 

The problem program can be responsible 
for this code if: 

1 . An access method routine in the 
problem program storage area has 
been, overlaid. 

2. An IOB, ECB, or DEB has been 
modified after an EXCP has been 
issued, but prior to the 
completion of an event. 



0F2 



If a trace table exists (trace option 
was specified at system generation), 
the instruction address in the new 
program check PSW, location 104(68), 
contains the address of a field of 
register contents. This field 
includes registers 10 through 1 (i?CP) 
or 10 through 9 (MFT) on an AEEND/SNAP 
dump, or 10 through 1 (both systems) 
on a stand-alone dump. 



If no trace table exists, the above 
field contains registers 10 through 1 
en both ABEND/SNAP (MFT only) and 
stand-alone dumps. 

Most frequently caused by incorrect 
parameters passed to a type I SVC 
routine . 



100 A device has been taken off-line 
without informing the system, or a 
device is not operational. 

If a trace table exists, the most 
current entry is an SIO entry 
beginning with 30. The last 3 digits 
of the first word give the device 
address. 

If a trace table does not exist, 
register 1 (in the SVRB for the ABEND 
routine) contains a pointer to the IOB 
associated with the device. 

101 The wait count, contained in register 
when a WAIT macro instruction was 
issued, is greater than the number of 
ECBs being waited upon. 

102 An invalid ECB address has been given 
in a POST macro instruction. 

If a POST macro instruction has been 
issued by the problem program, the ECB 
address is given in register 1 of 
either the trace table entry or the 
SVRB for the ABEND routine. 

If the POST was issued by an I/O 
interruption handler, the ECB address 
can be found in the IOB associated 
with the event. 

106 During a transient area load or a 

dynamic load resulting from a LINK, 
LOAD, XCTL, or ATTACH macro 
instruction, the fetch routine found 
an error. A description of the error 
is contained in register 15 of ABEND'S 
SVRB register save area: 



Appendix B: Completion Codes 91 



OD The control program found an 301 
invalid record type. 



0E The control program found an 
invalid address. The problem 
program may contain a relocatable 
expression that specifies a 
location outside the partition 
boundaries . 



OF A permanent I/O error has 308 

occurred., This error can probably 
be found in the trace table prior 
to the ABEND entry. 

Register 6 of ABEND'S SVRB register 

save area points to the work area used 

by the fetch routine. This area 

contains the IOB, channel program, RLD 

buffer, and the BLDL directory entry 

associcited with the program being 4 00 

loaded. 

122 The operator canceled the job and 
requested a dump. 

155 An unauthorized user (a user other 

than Dynamic Device Reconfiguration) 
has issued SVC 85. The user's task 
has been abnormally terminated by 
Dynamic: Device Reconfiguration. 

201 This completion code is identical to 
102, but applies to the WAIT macro 
instruction instead of POST. 

202 An invalid RB address was found in an 
ECB. The RB address is placed in the 
ECB when a WAIT macro instruction is 
issued. 4 06 

213 The error occurred during execution of 
an OPEN macro instruction for a data 
set on a direct-access device. 
Either: 

1. The data set control block (DSCB) 
could not be found on the direct 
access device. 

2. An uncorrectable input/output 

error occurred in reading or 506 
writing the data set control 
bl ock . 

Register 4 contains the address of a 
combined work and control block area. 
This address plus x*64' is the address 
of the data set name in the JFCBDSNM 
field of the job file control block 
CJFCB) . 

222 The operator canceled the job without 
requesting a dump. The cancellation 
was probably the result of a wait 
state or loop. 



A WAIT macro instruction was issued, 
specifying an ECB which has not been 
posted complete from a previous event. 
Either: 
1. The ECB has been reinitialized by 
the problem program prior to a 
second WAIT on the same ECB, or 



2. The high order bit of the ECB has 
been inadvertently turned on. 

The problem program requested the 
loading of a module using an entry 
point given to the control program by 
an IDENTIFY macro instruction. 

Register of LOAD'S SVRB register 
save area contains the address (or its 
complement) of the name of the module 
being loaded. 

The control program found an invalid 
IOB, DCB, or DEB. Check the following 
blocks for the indicated information: 

• IOB - a valid DCB address. 

• DCB - a valid DEB address. 

• DEB - ID of OF and a valid UCB 
address. 



UCB 

FF. 



a valid identification of 



Note : In systems with MVT, this code 
may appear instead of a 200 code, for 
the reasons given under 200. 

A program has the "only loadable" 
attribute or has an entry point given 
to the control program by an IDENTIFY 
macro instruction. In either case, 
the program was invoked by a LINK, 
XCTL, or ATTACH macro instruction. 

Register 15 of the LINK, XCTL, or 
ATTACH SVRB register save area 
contains the address of the name of 
the program being loaded. 

The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction in an overlay program or 
in a program that was being tested 
using the TESTRAN interpreter. 

The program name can be found as 
follows : 

1. If a LOAD macro instruction was 
issued, register in the trace 
table SVC entry or in the SVRB 
register save area contains the 
address (or its complement) of 
the program name. 
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2. If a LINK, XCTL, or ATTACH was 
issued, register 15 of the 
associated SVRB register save 
area contains the address of a 
pointer to the program name. 

Note ; Programs written in an overlay 
structure or using TESTRAN should not 
reside in the SVC library. 

604 During execution of a GETMAIN macro 

instruction, the control program found 
one of the following: 



705 



type of request is valid only for 
systems with MVT. 



The applicable SVC can be found in a 
trace table entry or in the PSW at 
entry to ABEND. 



Results from the same situations 
described under 704 for FREEMAIN macro 
instructions . 



1. A free area exceeds the 
boundaries of the main storage 
assigned to the task. This can 
result from a modified FQE. 

2 . The A-operand of the macro 
instruction specified an address 
outside the main storage 
boundaries assigned to the task. 

605 During execution of a FREEMAIN macro 
instruction, the control program found 
that part of the area to be freed is 
outside the main storage boundaries 
assigned to the task, possibly 
resulting from a modified FQE. 

Item 1 under the 604 completion code 
is also applicable to 605. 

606 During execution of a LINK, XCTL, 
ATTACH, or LOAD macro instruction, a 
conditional GETMAIN request was not 
satisfied because of a lack of 
available main storage for a fetch 
routine work area. Consequently, the 
request was not satisfied. 

The name of the load module can be 
found as described under completion 
code 506. 

60A Results from the same situations 

described under 604 and 605 for R-form 
GETMAIN and FREEMAIN macro 
instructions . 

613 The error occurred during execution of 
an OPEN macro instruction for a data 
set on magnetic tape. An 
uncorrectable input/output error 
occurred in tape positioning or in 
label processing. 

700 A unit check resulted from an SIO 

issued to initiate a sense command. 

The defective device can be determined 
from the SIO trace table entry that 
reflects a unit check in the CSW 
status . 

704 A GETMAIN macro instruction requested 
a list of areas to be allocated. This 



706 During execution of a LINK, LOAD, 

XCTL, or ATTACH macro instruction, the 

requested load module was found to be 
not executable. 

The name of the module can be found as 
described under the completion code 
506. 



804 The error occurred during execution of 
a GETMAIN macro instruction with a 
mode operand of EU or VU. More main 
storage was requested than was 
available. 



8 0b The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction. 

An error was detected by the control 
program routing for the BLDL macro 
instruction. This routine is executed 
as a result of these macro 
instructions if the problem program 
names the requested program in an EP 
or EFLOC operand. The contents of 
register 15 indicate the nature of the 
error: 

X'04' The requested program was 
not found in the indicated 
source. 

X'08' An uncorrectable 

input/output error occurred 
when the control program 
attempted to search the 
directory of the library 
indicated as containing the 
requested program. 

Register 12 contains the address of 
the BLDL list used by the routine. 
This address plus 4 is the location of 
the 8-byte name of the requested 
program that could not be loaded. 



8 0A The error occurred during execution of 
an R-form GETMAIN macro instruction. 
More main storage was requested than 
was available. 
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905 The address of the area to be freed 
C given in a FREEMAIN macro 
instruction) is not a multiple of 
eight. The contents of register one 
in either the trace table entry or 
ABEND'S SVRB register save area 
reflect the invalid address. 

90A Results from the same situations 

described under 905 for R-forms of 
GETMAIN and FREEMAIN macro 
instructions . 

A05 The error occurred during execution of 
a FREEMAIN macro instruction. The 
area to be freed overlaps an already 
existing free area. This error can 
occur if the address or the size of 
the area to be freed were incorrect or 
modified. 

The contents of registers and 1 in 
either the SVC trace table entry or 
ABEND'S SVRB register save area 
reflect the size and address. 

AOA Results from the same situations 
described under A05 for R-form of 
GETMAIN and FREEMAIN macro 
instructions . 

B04 This error occurred during execution 
of a GETMAIN macro instruction. A 
subpool number greater than 127 was 
specified. The problem program is 
restricted to using subpools 0-127. 
This error can occur if the subpool 
number was either incorrectly 
specified or modified. 

A displacement of nine bytes from the 
list address passed to GETMAIN in 



register 1 contains the subpool 
number. Register 1 can be found in 
either the SVC trace table entry or 
ABEND'S SVRB register save area. 



BOS Results from the same situation 

described under B04 for a FREEMAIN 
macro instruction. 



BOA Results from the same situations 

described under B04 and 805 for R-form 
of GETMAIN and FREEMAIN macro 
instructions. 

The subpool number can be found in the 
high order bytes of register in 
either the SVC trace table entry or 
ABEND'S SVRB register save area. 

B37 The error occurred at an end of 

volume. The control program found 
that all space on the currently 
mounted volumes was allocated, that 
more space was reguired, and that no 
volume was available for demounting. 

Eitner allocate more devices or change 
the program so that a device will be 
free when a volume must be mounted. 

Fnn An SVC instruction contained an 

invalid operand; nn is the hexadecimal 
value of the SVC. 

This error can occur if either an 
invalid instruction was issued by the 
problem program or an operand 
referring to an optional function was 
not included during system generation. 






94 Programmer's Guide to Debugging (Release 19) 



Appendix C: System Module Name Prefixes 



All load modules associated with a specific operating system component have a common 
prefix on their module names. This appendix lists the module name prefixes and the 
associated system component (s) . 



Prefix Component 



Prefix Component 



IBC Independent utility programs 

IEA Supervisor, I/O supervisor, and 
NIP 

IEB Data set utility programs 

IEC Input/output supervisor 

IEE Master scheduler 

IEF Job scheduler 

IEG TESTRAN 

IEH System utility programs 

IEI Assembler program during system 
generation 

IEJ FORTRAN IV E compiler 

IEK FORTRAN IV H compiler 

IEM PL/I F compiler 

IEP COBOL E compiler 

IEQ COBOL F compiler 

IER Sort/Merge program 

IES Report program generator 

IET Assembler E 

IEU Assembler F 

IEW Linkage editor/overlay 

supervisor/program fetch 

IEX ALGOL compiler 

IEY FORTRAN IV G compiler 

IFB Environment recording routines 

IFC Environment recording and print 
routines 



IFD 



On line test executive program 



IFF Graphic programming support 

IGC Transient SVC routines 

IGE I/O error routines 

IGF Machine check handler program 

IGG Close, open, and related routines 

IHA System control blocks 

IHB Assembler during expansion of 
supervisor and data management 
macro instructions 

IHC FORTRAN library subroutines 

IHD COBOL library subroutines 

IHE PL/I library subroutines 

IHF FL/I library subroutines 

IHG Update analysis program 

IHI Object program originally coded in 
ALGOL language 

IHJ Checkpoint/restart 

IHK Remote job entry 

UN 7094 emulator program for the 
Model 8 5 

IKA Graphic Job Processor 

IKD Satellite graphic job processor 
messages 

IKF USAS COBOL compiler 

ILB USAS COBOL subroutines 
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Appendix D: List of Abbreviations 



ABEND abnormal end-of-task 

| APR alternate path retry 

CCW channel command word 

CDE contents directory entry 

CPU central processing unit 

CSW channel status word 

CVT communications vector table 

DAR damage assessment routine 

DCB data control block 

| DDR dynamic device reconfiguration 

DEB data extent block 

DPQE dummy partition queue element 

DQE descriptor queue element 

ECB event control block 

FBQE fr€»e block queue element 

FQE free queue element 

FRB finch request block 

GQE gotten subtask area queue element 

IOB input/output block 

IPL initial program loading 

IRB interrupt request block 

LLE load list element 

LPRB loaded program request block 

LRB loaded request block 



MFT multiprogramming with a fixed 
number of tasks 



MVT multiprogramming with a variable 
number of tasks 

NIP nucleus initialization program 

PCP primary control program 

PIB partition information block 

PQE partition queue element 

PRB program request block 

PSA prefixed storage area 

PSW program status word 

QCB queue control block 

QEL queue element 

RB request block 

SCB STAE control block 

SIO start input/output 

SIRB supervisor interrupt request block 

SPQE subpool queue element 

SVC supervisor call 

SVRB supervisor request block 

SYSOUT system output 

TCB task control block 

TIOT task input/output table 

UCB unit control block 

XCTL transfer control 

XL extent list 
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Appendix E: ECB Completion Codes 



r r 

Hexadecimal 

Code 



Meaning 



7F000000 
41000000 
42000000 
44000000 

48000000 
4F000000 



Channel program has terminated without error. (CSW contents can be 
useful. ) 

Channel program has terminated with permanent error. (CSW contents can 
be useful.) 

Channel program has terminated because a direct access extent address 
has been violated. (CSW contents do not apply.) 

Channel program has been intercepted because of permanent error 
associated with device end of previous request. You may reissue the 
intercepted request. (CSW contents do not apply.) 

Request element for channel program has been made available after it 
has been purged. (CSW contents do not apply.) 

Error recovery routines have been entered because of direct access 
error but are unable to read home address of record 0. (CSW contents 
do not apply.) 
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Appendix F: UCB Sense Bytes 



\ BIT 
DEV1CE\ 





1 


i — 
2 


3 


4 


5 


6 


7 


2400 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 

CHK 


DATA 
CHK 


OVER- 
RUN 


WRT 
CNT 
ZERO 


DATA 

CNVTT 

CHK 


2311, 
2841 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


TRK 

CCND 

CHK 


SEEK 
CHK 


2301 , 2302, 
2303, 2314, 
2820 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


? ~ s 


INVAL 
ADDR 


2250 


CMD 
REJ 


SHOULD 

NOT 

OCCUR 


BUS 
OUT 


SHOULD 

NOT 

OCCUR 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


BUFFER 
RUN- 
NING 


SHOULD 

NOT 

OCCUR 


2280 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEG 


2282 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEGN 


1052, 
2150 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


P^^^^^^^^^^^^M 


1285 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1287 


CMD 

REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1288 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


SHOULD 

NOT 

OCCUR 


2495 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


POSN 
CHK 


SHOULD 

NOT 

OCCUR 


2540, 
2021 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


: '£*r*'\ 


UN- 
USUAL 
CMD 


•*-' 


1403, 
1443 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


/type 

/ BAR 


/TYPE 
/ BAR 




CH 9 

vlr'-.t' '■!■ 

#%« 

iiiiiiii 


1442, 
2501, 
2520 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


!^&-;jji,! 


2671, 
2822 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


••hT\ 


2260 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


2701, 
2702 


CMD 
RES 


INF 
REQ 


BUS 
OUT 


EQ 
CHK 
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Appendix G: Service Aids 



In addition to the debugging facilities discussed in this manual, IBM provides the 
following service aid programs to aid you in debugging. A complete description of each 
of these service aids and instructions for their use are found in the publication IBM 
System/360 Operating System Service Aids , GC28-6719. 



Program Name 



Functional Description 



IMDSADMP A stand-alone program, assembled with user-selected options, that dumps 
the contents of main storage onto a tape or a printer. The prograrr has 
two versions: 

• A high speed version that dumps the contents of main storage to a 
tape. 

• A low speed version that formats and dumps the contents of main 
storage either to a tape or directly to a printer. 

IMDPRDMP A problem program that reads, formats according to user supplied 

parameters, and prints the tape produced by execution of the stand-alone 
dump program assembled from the service aid IMDSADMP. The format of the 
printed output is similar to that produced by ABEND. 

IMCJQDMP A stand-alone program that reads, formats, and prints either the entire 
operating system data set SYS1.SYSJ0BQE, or selects and prints 
information related to a specific job in that data set. Because it 
operates independently of the operating system, IMCJQDMP can print the 
contents of the job gueue as it appeared at the time of abnormal 
termination. 

IMBMDMAP A problem that produces a map of the system nucleus, any load module, the 
resident reenterable load module area of an MFT system, or the link pack 
area of an MVT system. The listing produced by this program shows the 
locations of CSECTS, external references, and entry points within a load 
module. 

IMASPZAP A problem program that can inspect and modify either data records or load 
modules located on a direct access storage device. 

IMAPTFLS A problem program that identifies program temporary fixes (PTFs) and 
local fixes that have been applied to libraries. 

IMAPTFLE A problem program that produces the job control language (JCL) statements 
necessary to apply PTFs to a systeir; these JCL statements are tailored to 
the user's individual system. 
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Appendix H: Control Block Pointers 



This appendix summarizes the contents of the control blocks that are most useful in 
debugging. Control blocks are presented in alphabetical order, with displacements in 
decimal, followed by the hexadecimal counterpart in parentheses. Figure 34 illustrates 
control block relationships in the System/360 Operating System. Figure 3 5 shows 
relationships between storage control elements in a system with MVT. 



CVT - Communications Vector T able 
+0 Address of TCB control words 
+53(35) Address of entry point of ABTERM 
+193 (Cl) Address of secondary CVT (used 
only with Model 65 
Multiprocessing systems) 



RB - Request Block (MVT) 

+ 4 Last half of user's PSW 

+13 (D) CDE address 

+16(10) Resume PSW 

+ 29 (ID) Address of previous RB 



DCB - Data Control Block 

+40(28) ddname (before open); offset to 

ddname in TIOT (after open) 
+4 5 (2D) DEB address 
+69(4 5) IOB address 



DEB - Data Extent Block 

+1 TCB address 

+5 Address of next DEB 

+25(19) DCB address 

+33(21) UCB address 

+38(2 6) Address of start of extent 

+42 (2A) Address of end of extent 



TICT - Task Input/Output Table 



+ 
+ 8 
+24(18) 



+ 
+ 4 
+16(10) 

+20(14) 



variable- 

DD 



Job name 

Step name 

DD entries begin (one 

length entry for each 

statement) 

Length of DD entry 

ddname 

Device entries begin (one 4-byte 

entry for each device) 

Next device entry (if there is 

one) 



(Next DD entry begins at 24(18) 
plus length of first DD entry) 



ECB - Event Control Elock 



+1 



RB address or completion code 



1QB - Input/Outpu t Block 

-7 Address "of next IOB (BSAM, QSAM, 

and BPAM) 
+2 Sense bytes 
+5 ECB address 
+ 9 CSW 

+17(11) CCW list address 
+21(15) DCB address 



RB - Request Block (PCP and M FT) 

-8 Address of previous RB on load 

list 
-4 Address of next RB on load list 
+0 Module name 
+13 (D) Entry point address 
+16 (10) Resume PSW 
+29 (ID) Address of previous RB 



TCB - Task control Block (PCP and MFT) 



+1 Address of most recent RB 

+9 Address of most recent DEB 

+13 (D) TIOT address 

+ lo (10) Completion code 

+25(19) MSS boundary box address 

+37(25) Address of most recent RE on load 

list 

+113(71) Address of first save area 

+lbl(Al) Address of STAE control block 

+181 (B5) Address of the job step control 



TCB - Task control Block 



(MFT) with Subtaskinq 

+45 (2D) Address of TCB for job step task 
Address of TCB for next subtask 
attached by same parent task 
Address of TCB for parent task 
Address of TCB for most recent 
subtask 

Address of ECB to be posted at 
task completion 

+181 (B5) Address of the job step control 



+129(81) 

+133(85) 
+137(89) 

+145(91) 
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TCB - Task Control Block (MVT) 

+1 Address of roost recent RB 

+9 Address of roost recent DEB 

+13 (D) TIOT address 

+16 (10) Completion code 

+25(19) Address of roost recent SPCE 

+33(21) Bit 7 — Non-dispatchability bit 

+37(25) Address of most recent LLE 

+113(71) Address of first save area 

+125 (7D) Address of TCB for job step task 

+129(81) Address of TCB for next subtask 

attached by same parent task 
+133(85) Address of TCB for parent task 
+137(89) Address of TCB for most recent 

subtask 
+145(91) Address of ECB to be posted at 

task completion 



+153(99) Address of dummy PGE minus 8 

bytes 
+161 (Al) Address of STAE control block 
+181 (E5) Address of the job step control 



UCB - Unit Control Block 

-4 CPU ID (used only with Model 65 

Multiprocessing systems) 
+2 FF (UCB identification) 
+ 4 Device address 
+13 (D) Unit name 
+13(12) Device class 
+19(13) Device type 
+22(16) Sense bytes 
+40(2 8) Number of outstanding RESERVE 

requests (shared DASD only) 
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Figure 35. MVT Storage Control Flow 
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INDEX 



Indexes to systems reference library 
manuals are consolidated in the publication 
IBM System/360 Operating System; Systems 
Reference Library Master Index , GC28-6644. 
For additional information about any 
subject listed below, refer to other 
publications listed for the same subject in 
the Master Index. 

When more than one page reference is 
given, the major reference is first. 

Abbreviations, list of 96 

ABEND dumps 

contents of (MVT) 49-67 
contents of (PCP,MFT) 36-47 
guide to using (MVT) 66-67 
guide to using (PCP,MFT) 47,4 8 
how to invoke (MVT) 49 
how to invoke (PCP,MFT) 33 
introduction to 9 
samples of (MVT) 50,51 
samples of (PCP) 34,35 

ABEND macro instruction 33 

Abnormal termination, cause of 

in an ABEND/SNAP dump (MVT) 66 

in an ABEND/SNAP dump (PCP,MFT) 47 

Abnormal termination dumps (see ABEND 
dumps) 

Active RB queue 

description of 13 

instructions for using 30 

in a core image dump (MFT) 81,82 

in a core image dump (MVT) 85 

in a core image dump (PCP) 79 

in a stand-alone dump (MFT) 81,82 

in a stand-alone dump (MVT) 85 

in a stand-alone dump (PCP) 79 

in an ABEND/SNAP dump (MVT) 55-56,67 

in an ABEND/SNAP dump 

(PCP, MFT) 40-41,47 
in an indicative dump 

AMWP bits 

in an indicative dump 
meaning of 31 

APSW field, in an ABEND/SNAP dump 
(MVT) 55,66 

ATTACH macro instruction, effects of 15,16 

Attaching subtasks 17,18 



70 



70 



Boundary 

problem program 



31,43 



Catalog dump 33,34 

CDE 

as used with the load list 
format of 23,24 
in an ABEND/SNAP dump 57 
in a core image dump 85 
in a stand-alone dump 85 



14 



CHAP macro instruction 18 
Communications vector table (see CVT) 
Complete dump (MVT) 

description of 49 

sample of 50,51 
Completion codes 

description of common 91-94 

explanation of 30 

in an ABEND/SNAP dump (MVT) 52 

in an ABEND/SNAP dump (PCP, MFT) 38 

in an indicative dump 69 
COND parameter, 

to regulate job step execution 34 

to regulate space deletion 3b 
Contents directory 

description of' 14,23-24 

entries (see CDE) 
Control blocks 

descriptions of 2 5-26 

pointers in 100-101 

relationships between 

use in debugging 31 
Control information 10 
Control program nucleus 

ABEND/SNAP (MVT) 63 

ABEND/SNAP (PCP, MFT) 
Core image dumps 

contents of 73 

guide to using (MFT) 

guide to using (MVT) 

guide to using (PCP) 

introduction to 71 
CVT 

description of 25 

in a core image dump (PCP) 80 

in a stand-alone dump (PCP) 80 

pointers in 100 



25 



46-47 



80-84 
84-86 
79,80 



Data control block (see DCB) 
Data event control block 25 
Data extent block (see DEB) 
Damage assessment routine (DAR) 
DCB 

description of 25 

in a 



71 



in 
in 
in 
in 
in 



core image dump (MFT) 
core image dump (MVT) 



83 

86 

80 
83 
86 
80 



DD 



core image dump (PCP) 
stand-alone dump (MFT) 
stand-alone dump (MVT) 
stand-alone dump (PCP) 

pointers in 100 

statements 

required with ABEND/SNAP dumps 

sample of SYSABEND 36 



33-34 



DEB 



description of 25 

in a core image dump (MFT) 83 

in a core image dump (MVT) 86 

in a core image dump (PCP) 80 
in a stand-alone dump (MFT) 8 3 
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DEB (continued) 

in a stand-alone dump (MVT) 8 6 
in a stand-alone dump (PCP) 8 
in an ABEND/SNAP dump (MVT) 58 
in an ABEND/SNAP dump (PCP, MFT) 
pointers in 100 
DEB queue 

in a core image dump (MFT) 
core image dump (MVT) 
core image dump (PCP) 
stand-alone dump (MFT) 
stand-alone dump (MVT) 
stand-alone dump (PCP) 



44 



in 
in 
in 
in 
in 



83 
86 
80 
83 
86 
80 

in an ABEND/SNAP dump (MVT) 53 
in an ABEND/SNAP dump (PCP, MFT) 
Debugging procedure 

description of 30-32 
summary 32 
DECB 25 
j DELETE macro instruction 14 
Dequeued elements 37 
Descriptor queue element (see DQE) 
Destroyed queues 37 
Device considerations, 

for ABEND/SNAP dumps 33-34 
Dispatcher trace table entry (MVT) 
format of 28 
in a SNAP dump 64,66 
| in a core image dump 84-85 

in a stand-alone dump 84-85 
| Dispatching priority 17-18 
Displacements, how shown 9 
DQE 

format of 22-23 
j in a core image dump 86 
in a stand-alone dump 86 
in an ABEND/SNAP dump 59,67 
Dump (see individual type of dump, 

ABEND, indicative) 
Dump data set 
MVT 49 
PCP, MFT 33 
Dynamic area 

in systems with MVT 18 
| in systems with MFT 17 
in systems with PCP 16-17 



38 



e.g. 



ECB 

completion code 

description of 

in a core image 

in a core image 

in a core image 

in a stand-alon 

in a stand-alon 

in a stand-alon 

pointers in 10 

posting of, usi 

Event control bloc 

Extent list (see X 

External interrupt 

External trace tab 

format of 28 

in a SNAP dump 

in a core image 

in a stand-alon 



s, list of 97 
25 

dump (MFT) 
dump (MVT) 
dump (PCP) 

e dump (MFT) 

e dump (MVT) 

e dump (PCP) 



:ng ATTACH 16 

k (see ECB) 

L) 

ion 31,32 

le entry 

64,66-67 
dump 84-85 
e dump 84-85 



8 3-84 
86 
80 

83-84 

86 

80 



17-1$ 

18 

16 

19 



FBQE 
. format of 21-22 
I in a core image dump 86 
in a stand-alone dump 86 
in an ABEND/SNAP dump 60,67 

FINCH request block 11-12 

Finding the partition TCB 81 

FRB 11-12 

Fixed area 

in systems with MFT 
in systems with MVT 
in systems with PCP 

FQE 

format of (MFT,FCP) 
format of (MVT) 23 
in a core image dump (MFT) 
in a core image dump (PCP) 
in a stand-alone dump (MFT) 
in a stand-alone dump (PCP) 
in an ABEND/SNAP dump (MVT) 

Free areas 

in a core image dump (MFT) 

in a core image dump (PCP) 

in a stand-alone dump (MFT) 

in a stand-alone dump (PCP) 

in an ABEND/SNAP dump (PCP, MFT) 

Free block queue element (see FBQE) 

Free queue element (see FQE) 






84 
80 

84 

80 

59,67 

84 
80 

84 

80 



47 



General debugging procedure 

description of 30-32 

summary 32 
GETMAIN macro instruction 20 
Gotten subtask area 18-20 
Gotten subtask area queue element 20-21 
GQE 20-21 

Guide to using core image or a stand-alone 
dump 7 8 



Hardware error 31 

Hierarchy, main storage 19-21 



IEAPRINT 71,72 
IMAPTFLE 99 
IMAPTFLS 99 
IMA SP ZAP 99 
IMBMDMAP 99 
IMCJQDMP 99 
IMDPRDMP 99 
IMDSADMP 99 
Indicative dumps 

contents of 68-70 

description of 68 

guide to using 70 

introduction 9 
Input/output block (see IOB) 
Interrupt request block 11 
Interruptions 31-32 
Introduction 9 
IOB 

description of 25 

in a core image dump (MFT) 83 

in a core image dump (MVT) 86 
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IOB (continued) 

in a core image dump (PCP) 8 

in a stand-alone dump (MFT) 83 

in a stand-alone dump (MVT) 86 

in a stand-alone dump (PCP) 80 
pointers in 100 

I/O interruption 31-32 

I/O trace table entry 
format of 2 8 

in a core image dump (MFT) 83 

in a core image dump (MVT) 84-85 

in a core image dump (PCP) 79 

in a stand-alone dump (MFT) 83 

in a stand-alone dump (MVT) 84-8 5 

in a stand-alone dump (PCP) 79 
in a SNAP dump (MVT) 64,66-67 
in an ABEND/SNAP dump (PCP, MFT) 45,47 

IRB 11,12 



Job pack area 14-15 
Job pack area queue 14-15 
Job step 16-18 
Job step task (MVT) 18,49 
| JPAQ 14,15 



Keep dump 33-34 



LINK macro instruction, effects of 15 

Link pack area (MVT) 18 

LLE 

count field 14 

description of 14 

in an ABEND/SNAP dump (MVT) 53 

Load list 

description of 14 
instruction for using 30,32 
in a core image dump (MFT) 82 
in a core image dump (MVT) 85 
in a core image dump (PCP) 79 
in a stand-alone dump (MFT) 82 
in a stand-alone dump (MVT) 85 
in a stand-alone dump (PCP) 79 
in an ABEND/SNAP dump (MVT) 56,66 
in an ABEND/SNAP dump (PCP, MFT) 

41-42,47 
in an indicative dump 69 
in systems with MVT 14 
in systems with PCP or MFT 13-14 

Load list element (see LLE) 

LOAD macro instruction, effects of 16- 

Load module, storage control for 

in an ABEND/SNAP dump (MVT) 56-57,67 
in systems with MVT 23-24 

Loaded program request block 11,12 

Loaded request block 11,12 

LPRB 11,12 

LRB 11,12 



Main storage hierarchy support 
inclusion of 19-21 
effects on MSS boundary box 19-20 
effects on partition queue 19 



Main storage layout 

in systems with MFT with suntasking 

17-18 
in systems with MFT without subtasking 

17 
in the systems with MVT 18 
in system with PCP 11-17 
Main storage management 10 
Main storage supervisor's boundary box 

(see MSS) 
Machine check interruption 31-32 
MFT, systems with 

considerations in using an AEENE/SNAP 

dump of 47-48 
contents of an AEEND/SNAP duirp of 36-47 
guide to using a core image 

dump of 80-84 
guide to using a stand-alone dump of 

80-84 
how to invoke an AEEND/SNAP 

dump of 33-34 
main storage layout in 17,18 
storage control in 20-21 
task control characteristics of 17-18 
trace table entries in 25,82-83 
Model 65 Multiprocessing system- 
trace table formats 28 
prefixed storage area, as shown in an 

AEEND/SNAP dump (MVT) 63 
trace table entries in a SNAP dump 65 
Module name prefixes, list of 95 
description of (MFT) 20 
description of (PCP) 19 
in a core image dump (MFT) 84 
in a core image dump (PCP) 8 
in a stand-alone dump (MFT) 84 
in a stand-alone dump (PCP) 8 
in an ABEND/SNAP dump (MVT) 58-59 
starting address (PCP, MFT) 38 
Multiprogramming with a fixed number of 

tasks (see MFT, systems with) 
Multiprogramming with a variable number of 

tasks (see MVT, system with) 
MVT, systems with 

complete ABEND/SNAP dump of 50-51 
contents of an ABEND/SNAP dump 49-66 
guide to using a core image dump 

of 84-86 
guide to using a stand-alone dump of 

84-86 
guide to using an ABEND/SNAP dump 

of 66-b7 
how to invoke an ABEND/SNAP dump of 4 9 
load list in 14 
main storage layout in 18 
storage control in 22-24 
task control characteristics in 18 
trace table entries in 28,84-85 
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contents of 16-18 

in an AEEND/SNAP dump (MVT) 63 

in an ABEND/SNAP dump (PCP, MFT) 47 



Only loadable (CD 11 

Option 2 (see MFT, systeirs with) 
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Option 4 (see MVT, systems with) 
Overlaid problem program 37 



Partition (MFT) 17-18 
Partition queue element (see PQE) 
Partition TCBs 81 
PCP, system with 

contents of an ABEND/SNAP dump of 37-47 

guide to using a core image dump 
of 79-80 

guide to using a stand-alone dump of 
79-80 

guide to using an ABEND/SNAP 
dump of 47-48 

how to invoke an A BEND/ SNAP dump 
of 33-34 

load list in 13-14 

main storage layout in 16 

storage control in 19 

task control characteristics of 16-17 

trace table entries in 28,79-80 
PIE 38,52 

Pointers, control block 100-101 
PQE 

format of 21 

in a core image dump 86 

in a stand-alone dump 86 

in an ABEND/SNAP dump 59-67 
PRB 11 

Prerequisite publications 3 
Primary control program (see PCP, systems 

with) 
Priority 17,18 
Problem program, how to locate in a 

dump 30-32 
Problem program storage boundaries , in an 

ABEND/ SNAP dump (PCP, MET) 43 
Program check interruption 31 
Program check old PSW 

in an ABEND/SNAP dump (MVT) 55,66 

information in 31 
Program check trace table entry 

format of 28 

in a SNAP dump 64-65 

in a core image dump 8 0-85 

in a stand-alone dump 80-85 
Program interruption element (see PIE) 
Program request block 11 
Protection key 38 
PSW at entry to ABEND 

in an ABEND/SNAP dump (MVT) 52 

in an ABEND/SNAP dump (PCP, MFT) 38 
PSW, program check old (see program check 

old PSW) 
PSW, resume (see resume PSW) 



QCB 60 

Queue elements (MVT) 

Queues destroyed 37 



19,21-24 



RB 



as affected by LINK, ATTACH, XCTL and 

LOAD 15-17 
formats of 10-12 



RB (continued) 

in an AEEND/SNAP dump (MVT) 55-56 

in an ABEND/SNAP dump 
(PCP, MFT) 40-41,47 

in an indicative dump 69-70 

most recent 38,52 

name field, in a dump 30,32 

purpose of 12-13 

pointers in 100 

pointers to, in a core image dump 
(MFT) 81-82 

pointers to, in a core image dump 
(MVT) 86 

pointers to, in a core image dump 
(PCP) 79 

pointers to, in a stand-alone dump 
(PCP) 79 

queue (see active RB queue) 

sizes of 11-12 

types of 10-12 

usefulness in debugging ..„. 10-11,26,28 

when created 11-15 

which ones appear in a dump 30-31 
Re-creating the task structure 

MFT with subtasking 81 

MVT 8 5 
Reenterable load module area (MFT) 17 
Reference publications 3 
Reqion (MVT) 

contents of, in a core image dump 86 

contents of, in a stand-alone dump 86 

contents of, in an AEEND/SNAP dump 67 

description of 18 

storage control for 21-22 
Reqister contents 

in a save area 27 

in an ABEND/SNAP dump (MVT) 63-64 

in an ABEND/SNAP dump (PCP, MFT) 46 

in an indicative dump 69 
Request block (see RB) 
Resume PSW 

description of 11 

in an ABEND/SNAP dump (MVT) 56,65 

in an ABEND/SNAP dump (PCP, MFT) 41,47 

in an indicative dump 6 8,70 
Retain dump 33-34 
Rollout/rollin 

effects on partition queue 20 



Save areas 

format of 27 

in an AEEND/SNAP dump (MVT) 61-62 

in an ABEND/SNAP dump (PCP, MFT) 43 

Sense bytes, UCE 

in a core image dump (MFT) 83 
in a core image dump (MVT) 8b 
in a core image dump (PCP) 80 
in a stand-alone dump (MFT) 83 
in a stand-alone dump (MVT) 8 6 
in a stand-alone dump (PCP) 80 
table of 98 

Sequential partitioned system (see MFT, 
systems with) 

Sequential scheduling system (see PCP, 
systems with) 
| Service aids 99 
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82-83 


(MVT) 


84-85 


(PCP) 


79-80 


(MFT) 


82-83 


(MVT) 


84-85 


(PCP) 


79-80 



Set system mask trace table entry 

format of 29 

in a core image dump (MVT) 84-85 

in a stand-alone dump (MVT) 84-85 

in an ABEND/SNAP dump 64-65 
SIO trace table entry 

format of (MFT) 28 

format of (MVT) 28-29 

format of (PCP) 28 

in a SNAP dump (MVT) 

in a core image dump 

in a core image dump 

in a core image dump 

in a stand-alone dump 

in a stand-alone dump 

in a stand-alone dump 

in an ABEND-SNAP dump 
(PCP, MFT) 45,47-48 
SIRB 11-12 
SNAP dumps 

contents of (MVT) 49-66 

contents of (PCP, MFT) 36-47 

guide to using (MVT) 66-67 

guide to using (PCP, MFT) 47-48 

how to invoke (MVT) 49 

how to invoke (PCP, MFT) 33-34 

introduction to 9 
SNAP macro instruction 33 
Snapshot dumps (see SNAP dumps) 
Space considerations, for ABEND/SNAP 

dumps 33-34 
SPQE 

format of 22-23 
| in a core image dump 86 

in a stand-alone dump 86 

in an ABEND/SNAP dump 58,67 
SQS (see system queue space) 
SSM (see set system mask trace table entry) 
Stand-alone dumps 

areas shown on 75-76 

description of 75-76 

contents of 75-76 

guide to using (MFT) 80-84 

guide to using (MVT) 84-86 

guide to using (PCP) 79-80 

how to invoke 75 

introduction to 9 
Storage control 

in systems with MFT with subtasking 20 

in systems with MFT without subtasking 
20-21 

in systems with MVT 21-24 

in systems with PCP 19 
Subpool 

definition of 22 

in a core image dump 86 

in a stand-alone dump 86 

in an ABEND/SNAP dump 58-59,67 

queue elements (see SPQE) 
Subtask, as created by ATTACH 15-16 
Supervisor calls, list of 87-90 
Supervisor interrupt request block 11-12 
Supervisor request block 11-12 
SVC interruption 31-32 
SVC trace table entries 

format of (MFT) 28 

format of (MVT) 28 

format of (PCP) 28 



SVC trace table entries (continued) 
in a SNAP dump (MVT) 64-65< 
in a core image dump (MFT) 83 
in a core image dump (MVT) 8 4-8 5 
in a core image dump (PCP) 79-80 
in a stand-alone dump (MFT) 83 
in a stand-alone dump (MVT) 84-85 
in a stand-alone dump (PCP) 79-80 
in an ABEND/SNAP dump (PCP, MFT) 45,47 

SVCs, list of 87-90 

SVRB 11-12 

SYSABEND DD statement 
description of 33-34 
samples of 33 

SYSOUT, as a dump data set 33-34 

System control blocks (see control blocks) 

System differences in task control 16-18 

System failure 71 

System queue space (MVT) 18 

System tasks 16-18 

System wait TCB 85 

SYS1.DUMP data set 71 

SYSl.SVCLIB 

SYSUDUMP DD statement 33-34 



Task completion code (see completion codes) 

Task control block (see TCB) 

Task control differences, by system 16-18 

Task dispatching priority 17-18 

Task input/output table (see TIOT) 

Task management 10-12 

Task supervision 10-12 

Task structure, recreating the, using a 

core image dump (MVT) 85 
Task structure, recreating the, using a 

stand-alone dump (MVT) 85 
Task switch trace table entry (MFT) 

format of 28 

in core image dump 82-83 

in a stand-alone dump 82-83 

in an ABEND/SNAP dump 47 
Task switching (MFT) 17-18 
TCB 

description of 10 

in an ABEND/SNAP dump (MVT) 52-54 

in an ABEND/SNAP dump (PCP, MFT) 38-40 

information available through 10 

locating, in a core image dump 85 

locating, in a stand-alone dump 85 

pointers in 100-101 

pointers to, in a core image dump (MFT) 
76 

pointers to, in a stand-alone dump 
(MFT) 81 

queue (MFT) 17 

queue (MVT) 18 

relationships 17-19 
TCBLTC 17,100-101 
TCENTC 17,100-101 
TCBOTC 17,10Q-101 
TCBTCB 17,100-101 
Termination, abnormal (see abnormal 

termination) 
TIOT 

description of 25 

pointers in 100 
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Traces 27-29 
Trace table 

control block 79,82,84 

delimiting entries, in an ABEND/SNAP 
dump (MFT) 47 

description of 27-29 

format of entries (MFT) 28 

format of entries (MVT) 28 

format of entries (PCP) 28 

format of entries 
(Mod 65 multiprocessing systems) 29 

in a SNAP dump (MVT) 64-65 

core image dump (MFT) 8 2-83 
core image dump (MVT) 84-85 
core image dump (PCP) 79-8 
stand-alone dump (MFT) 8 2-83 
stand-alone dump (MVT) 8 4-8 5 
stand-alone dump (PCP) 79-8 

in an ABEND/SNAP dump (PCP, MFT) 4 5 

samples of entries (MFT) 82-8 3 

samples of entries (MVT) 84-85 

samples of entries (PCP) 79-80 

usefulness in debugging 31-32 
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in a core image dump (MVT) 8 6 
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in a stand-alone dump (MFT) 83 

in a stand-alone dump (MVT) 86 
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in an AEEND/SNAP dump (PCP, MFT) 44 
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Unit control block (see UCB) 
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Wait list element 15,20 

WLE 15,20 

XCTL macro instruction, effects of 16 
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in a stand-alone dump 86 
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